SMF Online Manual

*
  • Home
  • Community
  • Download
  • Customize
    • Modifications
    • Themes
    • Upgrades
  • Support
    • Function Database
  • Online Manual
  • About
  • Contribute
  • Development
 

Documentation of the moment:

Now announcing the SMF wiki (beta)


  • Home
  • Help
  • Search
  • Login
  • Register

  • SMF Online Manual »
  • Installing, Converting, and Upgrading SMF »
  • Installing SMF »
  • Topic: Installing SMF
 
Install SMF InstallingIntroduction to Installing SMFClient and Server RequirementsServer RequirementsServer RecommendationsObtaining SMFUploading SMFInstalling SMFInstalling and Upgrading using Webinstall Upgrading Converting
Using SMF User Moderator Administrator
Advanced Mods and Themes More Info
Glossary Terminology FAQs References Feature List What's New
Comments Feedback Requests

Updated Documentation: The Online Manual has moved. All updates to the documentation are now taking place in the new Online Manual. Please see the new Online Manual, and learn how you can help, as it continues to grow and improve.

Updated content on Wiki: This documentation is outdated, please refer to the wiki article for more up to date information.

« previous next »
Installing SMF
Steps for Installing SMF:
  • Check Client Requirements
  • Check Server Requirements
  • Check Server Recommendations
  • Obtain SMF
  • Upload SMF
  • Run the SMF installer
  • Using Webinstall

Install screenAssuming the previous steps went well, you should now have the SMF source files on your server with their appropriate permissions set. All that is needed now is to run the install.php file to configure your database, settings and admin account.

Open up your web browser and browse to http://www.yourdomain.com/smf/install.php (where smf is the directory name you chose earlier). Provided you set the permissions correctly on Settings.php and Setting_bak.php, you should see a form asking for various settings. Fill these in as follows:

  • Forum Name: This will be the name of your forum. It starts as "My Community" but you should probably change it.
  • Forum URL: This is the url your Forum will be located at, the SMF installer should have worked this out for itself so in most cases you can leave this setting at its default value.
  • Database type: Select from a list of supported database schemes you are able to use. If MySQL is available, it is generally recommended to use that as it has been tested and supported in SMF since SMF was first released. Newer schemes such as PostgreSQL and SQLite may have more bugs in them, especially while 2.0 is in beta stage.
  • Server name: This is where we specify the location of the database.. 99% of the time this will be localhost.
  • Username: This is the username for your database. Often you will have to set this up in your web host's control panel. If in doubt, consult your host.
  • Password: This is the password for your database. Often you will have to set this up in your webhost's control panel. If in doubt, consult your host.
  • Database name: This is the name of your database. Often you will have to set this up in your webhost's control panel. If in doubt, consult your host.
  • Database prefix: This is a prefix to the table names in your database. It enables you to run more than one application on a single database. You should generally leave it as smf_, unless you are installing a second copy of SMF on the same database.

[vers=1.1]In SMF 1.1, all references to "database" are first proceeded with the text MySQL and MySQL is the only database scheme that SMF 1.1 supports. In SMF 2.0, there are other databases available that SMF can use.[/vers]

Once you have filled in all of the settings, click on proceed, and you will now be asked for details of your admin account; this will create your username on the forum. As a security measure, you are also asked for your database password. Once you have filled in the form, click on proceed.

Your Forum is now installed and you can browse to it. However, before doing so, it is VERY IMPORTANT that you delete the install.php file from the server as leaving it there is a major security risk. The installer will offer you a check box to do this, if it fails, you will see a warning on your forum, if this appears you must remove the file manually. To do so, use your FTP program to return to the directory where you installed SMF, locate install.php, select it, and hit delete.

Congratulations, you have now successfully installed SMF. Follow the link to your forum. We hope you enjoy using SMF! If you have any support questions, feel free to ask them in our support forum, please also read on for more information on using SMF.
Print
Reply
Reply with quote



Comments:
Blagojce made the following comment on May 10, 2008, 09:45:14 AM:

When i open install.php swoh me this message: "Sorry, this installer requires PHP!"
What's the problem?

Jade made the following comment on August 14, 2008, 11:28:49 PM:

You need to install php onto your server :).

zoydster made the following comment on August 25, 2008, 12:44:07 AM:

manual install is all that worked for me, finally
need to know if the files & folders that were recommended to be chom'd to 777 during install can be set back or what chom is the best?
(i had a site hacked before cuz i didn't have the correct chom's)
a response would be greatly appreciated
thank you

they were:
soberati/themes/default/languages/Install.english.php
Settings.php
Settings_bak.php
agreement.txt
attachments
avatars
Packages
Smileys

Jade made the following comment on August 25, 2008, 06:50:48 AM:

Maybe see this:
http://docs.simplemachines.org/index.php?topic=5.msg3656#msg3656

Leave them CHMOD'd to the things they were put to in the install, or mods and things wont install right, you wont be able to make a custom registration agreement etc, if you have the wrong one. I don't know what happened before, but if someone can get into your site NO amount of permissions will help you. I speak from experience on that one ;).

Gregg made the following comment on September 03, 2008, 11:50:42 AM:

I get this error while trying to install.

install.php: parse error, expecting `'('' on line 26
$GLOBALS['current_smf_version'] = '1.1.5';

Jade made the following comment on September 03, 2008, 02:12:03 PM:

Try re-uploading the install script, it may have become corrupted as it should not have phrase errors.

skullmonkey made the following comment on September 13, 2008, 07:55:01 AM:

The server encountered an unexpected condition which prevented it from fulfilling the request.
The script had an error or it did not produce any output. If there was an error, you should be able to see it in the error log.

Jacob made the following comment on September 13, 2008, 01:06:57 PM:

I Really Want/need This Script.  I Uploaded All Files. I Named the Folder "SMF".  When I run "Install.php" I keep Getting The Following Message
"This installer was unable to find the installer's language file or files. They should be found under:
/smf/Themes/default/languages"

I Checked The Languages File It is where Its Supposed To Be. I Deleted it Reloaded It Several Times, tried a different Ftp Software but Them all give the Same error message above.  Someone Please Help Me?

Jade made the following comment on September 13, 2008, 03:05:50 PM:

http://docs.simplemachines.org/index.php?board=82.0

Please check the above section, if that does not help you I encourage you to ask for support over on the community.

Logitech made the following comment on October 20, 2008, 07:25:09 PM:

Thank you for the smf! I was able to install my forums smoothly :) Luckily I was able to get my information for the smf installer from last year :P..  :D :D

chris made the following comment on October 21, 2008, 03:32:15 AM:

i get this error message..

Parse error: syntax error, unexpected $end in /home/a1991356/public_html/Sources/Subs.php on line 1835

please help me with this...

Jade made the following comment on October 21, 2008, 10:49:10 AM:

Help is given on the community. If you have an error like that you should re-upload your files.
That error should not occur when installing SMF :).

blago made the following comment on October 28, 2008, 07:22:22 AM:

Well,my problem is like this. I've up-loaded the files, I start install.php and enter info, but when I click proceed,it sends back 404, the page doesn't exist!

Jade made the following comment on October 28, 2008, 10:24:03 AM:

I would suggest contacting your host, maybe check all of the files do exist first though :).

XjX made the following comment on November 22, 2008, 08:28:42 AM:

Ive just tried installing the install file and i get the following error,
The installer was unable to access the "freedomr" database. With some hosts, you have to create the database in your administration panel before SMF can use it. Some also add prefixes - like your username - to your database names.
I have made a database as suggested and added it to the settings.php and settings_bak.php but still get the same error, can someone help please....Julie (XjX)

Jade made the following comment on November 22, 2008, 01:36:40 PM:

You also need to make a user for the database, if using cPanel, click the "MySQL Databases" icon and create a new user :)

lubimo made the following comment on December 15, 2008, 06:18:00 AM:

I have a problem with the Installer.
When I click "Proceed" button the page get's reload and I must retype the fields, but it is the same.
Please, help!

Jade made the following comment on December 15, 2008, 07:08:56 PM:

If it's asking for FTP details, some servers don't support that, you need to CHMOD your files again :)

Michael Holdcroft made the following comment on February 09, 2009, 03:41:32 AM:

I have everything set up and manually CHMOD'ed all the files, have entered the relevant information into the Settings files and still get this message when trying to get the installation going:

Quote
Unable to connect to FTP server with this combination of details.

I have checked the settings and they are ok. My FTP Software accesses the server without any problem.

The install programm is set up on localhost. If I enter the FTP URL, the install programme does not find the relative install path.

Where do I go from here?

Michael

Jade made the following comment on February 09, 2009, 07:49:50 AM:

Quote from: Jade on December 15, 2008, 07:08:56 PM
If it's asking for FTP details, some servers don't support that, you need to CHMOD your files again :)

As above, your localhost may not like that. I suggest you try a different chmod, such as 777 or 755.

Quote from: Jade on February 08, 2009, 01:22:24 AM
You may need to ensure your Chmod is going to all subfiles and folders :)

piojunbabia made the following comment on February 15, 2009, 06:10:33 AM:

I have problems too... please help..
After filling up the information on the install.php page and then click "Proceed" I receive this error message..

Quote from: errorpage after Proceed

Cannot connect to the MySQL database server with the supplied data.

If you are not sure about what to type in, please contact your host.



Access denied for user 'hionline'@'localhost' (using password: NO)

Click here to try this step again.


please help...

Jade made the following comment on February 15, 2009, 05:56:55 PM:

Your account name should prefix your database names.

For example if your account name was "alan" it would be:

alan_dbName
alan_dbUser

If you're still having trouble, contact your host :)

Austin made the following comment on February 17, 2009, 04:59:22 PM:

Gahh!

"Cannot connect to the MySQL database server with the supplied data.

If you are not sure about what to type in, please contact your host.
Can't connect to local MySQL server through socket '/var/lib/mysql/mysql.sock' (2)
Click here to try this step again. "

Help!

UMD Union made the following comment on February 18, 2009, 10:39:32 AM:

After checking my Host's Control Panel (VistaPanel), I used all of the information required, and I'm still being greeted by an error page. Here it is:

Cannot connect to the MySQL database server with the supplied data.

If you are not sure about what to type in, please contact your host.
Access denied for user '[Host's Username]'@'[I.P. Address]' (using password: YES)

Sorry if this has been answered before.

Jade made the following comment on February 18, 2009, 10:57:18 PM:

Please try contacting your hosts, both Austin and UMD Union :)

shari made the following comment on February 25, 2009, 11:45:17 AM:

mine says


"Unable to connect to FTP server with this combination of details.

530 Login authentication failed"

Jade made the following comment on March 02, 2009, 03:01:34 PM:

Please contact your host for the correct details, or use an FTP client for CHMODDING files :)

farha made the following comment on March 03, 2009, 09:41:29 AM:

I am trying to install SMF on my local IIS and I am getting the following message 'You're on a windows server, and some crucial files are not writable. Please ask your host to give write permissions to the user PHP is running under for the files in your SMF installation. The following files or directories need to be writable:
attachments
avatars
Packages
Packages/installed.list
Smileys
Themes
agreement.txt
Settings.php
Settings_bak.php
' . I have made all the specified files writable but still keep on getting the message. Help me out on this please..

Jade made the following comment on March 03, 2009, 06:48:23 PM:

Have you tried making them all writeable?

If you have problems still, please seek help here:
http://www.simplemachines.org/community/index.php?board=10.0

griffinbikini made the following comment on March 06, 2009, 07:51:14 PM:

OK, color me stupid, but when I ran the webinstall, it didn't include a file called "install.php" anywhere in the target directory.

HELP?!

Jade made the following comment on March 07, 2009, 07:45:06 PM:

I'm not sure I understand the problem? Try web install again? Maybe it doesnt work on your server?

griffinbikini made the following comment on March 08, 2009, 03:59:12 PM:

Should work on my server, it's PHP-enabled and MySQL is active and ready. There's no file called install.php in the target directory, just a folder called "Themes"

Jade made the following comment on March 08, 2009, 06:58:02 PM:

Please try uploading manually or asking for support on the community. I can't help with this.

http://www.simplemachines.org/community/index.php

alex made the following comment on March 12, 2009, 10:47:04 PM:

Alright I made a mistake - the first thing I did when I installed was to go to the Admin panel and I changed the filepath of my forum. Now I can't get into the admin panel with a 404 message. The forum loads fine on the original filepath, just the admin tab no longer works. Do I need to reinstall?

Jade made the following comment on March 14, 2009, 12:31:26 PM:

No :)


See here:
http://docs.simplemachines.org/index.php?topic=469.0

Muriel made the following comment on March 18, 2009, 04:17:23 PM:

Hi,
after going trough the installprocess i receive the message:

Can't connect to local MySQL server through socket '/var/run/mysqld/mysqld.sock' (2)

what is the problem? thx for help

edit: Managed it today, i needed to create a MySQL Database first and than take this data

B made the following comment on March 19, 2009, 08:02:47 PM:

Thanks for posting the solution, Muriel, as it seems other people are running into this problem, as well. :)

B

CLSSY56 made the following comment on March 20, 2009, 01:15:59 PM:

I've done all the previous, but when I use my browser to get to install.php, the screen stays blank.

Jade made the following comment on March 22, 2009, 09:32:01 PM:

Please ensure php is installed and the files are uploaded correctly :)

SheWolf made the following comment on April 03, 2009, 11:09:48 PM:

I installed the files, went to run the installer and got a 404 error saying that the files were either moved or deleted.  I can still see them in there.

Jade made the following comment on April 04, 2009, 01:38:17 PM:

This was answered on the uploading page:

Quote from: Jade on November 12, 2008, 10:27:15 AM
Please use an FTP program to CHMOD your files :)
http://docs.simplemachines.org/index.php?topic=480.0
http://docs.simplemachines.org/index.php?topic=477.0

Good luck :)

TugaShot made the following comment on February 12, 2010, 04:09:49 AM:

I can install the forum everithing cool, but why i cant login ? why ppl cant log in ?? Ports are OPEN ?

Trekkie101 made the following comment on February 12, 2010, 06:39:09 AM:

Hi TugaShot,

Please post details of your problem to our support forums across at www.simplemachines.org/community were we will be able to help you.

Mirelly made the following comment on March 05, 2010, 09:15:15 AM:

While waiting for my server's tech support to respond. I uploaded and chmodded all files successfully. Running the raw install.php produces a 500 Internal Server Error, running the same file via FTP gets a "You Need PHP error".

I know PHP is installed and available because the host server's default "this domain has been registered" is a perfectly operational PHP page with numerous PHP calls and no errors.

It may be significant that I can find no trace of a php.ini file in my accessible directories. And cPanel's PHP configuration module only informs me what the settings are (they are set by the server admin and none of the settings are relevant to whether or not it runs at all).

prpl made the following comment on April 21, 2010, 02:23:05 PM:

I keep getting a 403 (forbidden) error when I try to go to the install page. All the files are there and I've double checked that I have the permission to use them.

Colin made the following comment on May 04, 2010, 06:47:40 PM:

Got the install form to show up, filled it out & got this message
"Can't connect to local MySQL server through socket '/var/run/mysqld/mysqld.sock' (2)"

Turns out my host does not allow database socket connections!  Is there any way to make this work in my case?  Thanks.

FIAN made the following comment on May 29, 2010, 10:09:14 AM:

Quote
Unable to connect to FTP server with this combination of details.

530 Login authentication failed

Please Help me  ::)

Forumite made the following comment on June 10, 2010, 05:43:03 PM:

Why do I get this error message when I try to install SMF?

The installer was unable to access the database. With some hosts, you have to create the database in your administration panel before SMF can use it. Some also add prefixes - like your username - to your database names.

Click here to try this step again.

Lithium made the following comment on July 07, 2010, 03:15:35 PM:

I'm having trouble. When I finish the installer just blank site appears(and as I understood it,it should download packages).
This is the link: http://zvonce.tk/forum
I don't know how to make this into an actual forum.

Please help me


Advertisement:
  • SMF 2.0.1 | SMF © 2011, Simple Machines
  • XHTML
  • WAP2

Page created in 0.195 seconds with 20 queries.
Page served by: 10.0.100.114