SMF1.1:Server settings

From Online Manual

Jump to: navigation, search

Please see SMF1.1:Server settings or SMF2.0:Server settings depending on the version of SMF you are using.

The Server Settings section of the Administration Center allows you to change the basic settings for your forum. Be very careful with these settings, as they may render the forum dysfunctional if a setting is changed to an invalid value.

If SMF does not have write access to the Settings.php file a notice will appear under the heading stating "These settings cannot be changed because Settings.php is read only."

Core Configuration

  • Server on which the database resides - Hostname or IP of the database server. If the database server is on the same machine as the web server, it's safe (and considerably more efficient!) to use 'localhost' for this setting. Otherwise, either an IP address or a web address (hostname) is required. If a port number is required, use the appropriate format for your database server. So, if your database server is at on port 3030
  • Database Username - Name of the user connecting to the database.
  • Database Password - Password for access to the database server.
  • Database Name - The name of the database. This database must exist, and must have SMF's tables and data in it.
  • Database Tables Prefix - The prefix of the database tables. During installation, SMF will add about 30 tables to the database. Each of which will use the prefix that was configured during the installation procedure. For example, if the prefix is 'smf_', the tables will be given the names 'smf_attachments', 'smf_boards', 'smf_messages', etc. If you want to install another forum or software package in the same database, simply chose a different prefix, and the tables won't interfere with each other.
  • Use a persistent connection - Enable or disable persistent connections for connecting to the database. A persistent connection keeps the connection active to increase performance (although in many cases the gain is minimal). If you aren't on a dedicated server, this may cause you problems with your host.
  • Send emails on MySQL connection error - Enables or disables sending an email to the administrator on a database connection or query error. This function is limited to sending only one email per every three days.
  • Maintenance mode? - Sets whether the forum is in maintenance mode. If ticked Maintenance mode will be activated. Thus, only administrators can use the forum as usual. Other users get a 'this forum is in maintenance mode' message. The database may still be accessed for user authentication (to tell if the member is an administrator).
  • Subject for display - Title for the Maintenance Mode message. This will be shown to users only if Maintenance mode is on.
  • Message for display: - Description of why the forum is in maintenance mode. It will be shown to user only if Maintenance mode is on.
  • Forum Title - The name of your forum. This is used in the title of your forum pages. As well as the name of the sender of email notifications and on the footer of each email message sent by your forum.
  • Webmaster Email Address - Email address from which to send all topic notifications, personal message notifications, newsletters, etc. This address also receives database error warnings, should they occur.
  • Cookie name - Name of the cookie to set for authentication purposes. Changing this value will cause everyone to be logged out.
  • Default forum language
  • Forum URL - The URL to your forum's directory, without the trailing slash (/). This URL is used throughout SMF - all dynamically generated URLs (except those with their own settings) are based on this setting.
  • SMF Directory - This sets the directory where SMF is installed. It's used to locate files like Settings.php, SSI.php, agreement.txt, and the Packages directory. No trailing slash (/) should be added.
  • Sources Directory - The path to where the source files are stored. No trailing slash (/) is allowed. It does not need to be the same as the above path. You can have your SMF Directory in one place and Sources Directory in another place if you want. For security, you may wish to place your Sources directory in a location that is not accessible by the web server.

Feature Configuration

  • Mail type - This setting allows you to choose either PHP's default settings, or to override those settings with SMTP. PHP does not support using authentication with SMTP (which many hosts require), so if you want to have this you should select SMTP. Please note that SMTP can be slower, and some servers will not take usernames and passwords. You don't need to fill in the SMTP settings if this is set to PHP's default. The SMTP settings below should be filled in accordingly should you choose to override PHP with SMTP.
  • SMTP server
  • SMTP port
  • SMTP username
  • SMTP password
  • Default login cookies length (in minutes) - The amount of time, in minutes, that the login form will use if no other amount is selected.
  • Enable local storage of cookies (SSI won't work well with this on.) - (SSI won't work well with this on.) SMF uses cookies to store login information on the client computer. Cookies can be stored globally ( or locally ( Check this option if you're experiencing problems with users getting logged out automatically. Globally stored cookies are less secure when used on a shared webserver (like Tripod). Local cookies don't work outside the forum directory so, if your forum is stored at, pages like cannot access the account information. Especially when using SSI.php, global cookies are recommended.
  • Use subdomain independent cookies (turn off local cookies first!)
  • Optimize tables every how many days? (0 to disable.)
  • Maximum users online when optimizing (0 for no max.)
  • Automatically fix broken tables - This will automatically fix broken tables and resume like nothing happened. This can be useful, because the only way to fix it is to REPAIR the table, and this way your forum won't be down until you notice. It does email you when this happens.
  • Enable compressed output - This option will compress output to lower bandwidth consumption, but it requires zlib to be installed.
  • Use database driven sessions - This option makes use of the database for session storage - it is best for load balanced servers, but helps with all timeout issues and can make the forum faster.
  • Allow browsers to go back to cached pages - Turning this on will decrease the bandwidth your forum uses, and make it so clicking back will not reload the page - the downside is that the (new) icons won't update, among other things. (unless you click to that page instead of going back to it.)
  • Seconds before an unused session timeout - This is the number of seconds for sessions to last after they haven't been accessed. If a session is not accessed for too long, it is said to have "timed out". Anything higher than 2400 is recommended.


On this page you can set-up caching of your forum.

You should only enable caching if you know what you are doing and SMF detects that you have an accelerator installed. On the page you will see bullets in red letters telling you what accelerators you have installed. If you have none installed it will say "No Caching Detected!".

To setup an accelerator, select the cache level you want next to Caching Level. Also enter the Memcache settings into the next part. If you need more information, please contact your host regarding accelerators.

  • Caching Level - Sets the caching level between 1 and 3. No caching is also an option, but this is not recommended.
  • Memcache settings - If you are using memecached you need to provide the server details. This should be entered as a list, with a comma separating each item, as is shown in the following example: server1,server2,server:port,server4. Note that if no port is specified, SMF will use port 11211. SMF will attempt to perform rough/random load balancing across the specified servers.