(→Set File/Folder Permissions: "this will work on most servers") |
(→Setting File Permissions With FTP: clarification 1and1 and other hosts using suphp may require 766/644 permissions.) |
||
| Line 23: | Line 23: | ||
If the permission on your files or folders does not make them writable, the SMF installer will report the problem. In that case, use your FTP client or host panel to reset the permissions for the files or folders the installer reports. | If the permission on your files or folders does not make them writable, the SMF installer will report the problem. In that case, use your FTP client or host panel to reset the permissions for the files or folders the installer reports. | ||
'''Please note:''' On some servers, the 777 or 666, permission may cause Internal Server Errors (ISEs) or similar errors. If an ISE or other error has occured on the server, the administrator may change the value one step back, to 755 or 644. | '''Please note:''' On some servers, the 777 or 666, permission may cause Internal Server Errors (ISEs) or similar errors. If an ISE or other error has occured on the server, the administrator may change the value one step back, to 755 or 644. In come cases, SMF does not detect the errors that result when the host does not permit 777 or 666 permissions. In such a case, the SMF Package Manager might report the mod install succeeded, but one or more steps did not get done. | ||
If your host uses suphp (hosts such as 1and1.com), then you may be permitted to use CHMOD to set 777/666 permissions on files, but may see 500 errors when SMF attempts to use those files. If your host uses suphp, use permissions of 755 for directories and 644 for files. | |||
Revision as of 14:50, 11 January 2013
Set File/Folder Permissions
After the install archive has been uploaded and extracted, you need to set the files' permissions. This is commonly done by use of the Unix utility CHMOD. The correct CHMOD value for SMF folders is either 777, 775 or 755, and 666 or 644 usually for files, depending on your hosting service. There are two methods for this step, the method used depends on the hosting service that you use.
Setting File Permissions With the Installer
The SMF installer can set file permissions simply and easily. Navigating to the directory where SMF is located should redirect you to the install.php file and prompt the installer. For example: www.yourdomain.com/forum/install.php. If the installer detects files that need their permissions adjusted it will prompt for FTP details so it can CHMOD the files it requires for the install. This will work on most servers. If this does not work to you, you may choose to use to set file permissions using FTP.
Setting File Permissions With FTP
Using a control panel or FTP client, file permissions can be changed quickly and easily. Usually, FTP programs will allow permissions to be changed by right-clicking files/directories and selecting "Properties", "Attributes" or "Permissions". The desired numerical value can be entered, or if provided, check boxes can be changed.
The following files and directories must be writable. Depending on how your server is set up, this could mean that they must have CHMOD values of 644, 664 or 666 for files, and 755, 775 or 777 for folders:
- /attachments
- /avatars
- /Packages
- /Packages/installed.list
- /Smileys
- /Themes
- /Themes/default/languages/Install.english.php
- agreement.txt
- Settings.php
- Settings_bak.php
- install.php
If the permission on your files or folders does not make them writable, the SMF installer will report the problem. In that case, use your FTP client or host panel to reset the permissions for the files or folders the installer reports.
Please note: On some servers, the 777 or 666, permission may cause Internal Server Errors (ISEs) or similar errors. If an ISE or other error has occured on the server, the administrator may change the value one step back, to 755 or 644. In come cases, SMF does not detect the errors that result when the host does not permit 777 or 666 permissions. In such a case, the SMF Package Manager might report the mod install succeeded, but one or more steps did not get done.
If your host uses suphp (hosts such as 1and1.com), then you may be permitted to use CHMOD to set 777/666 permissions on files, but may see 500 errors when SMF attempts to use those files. If your host uses suphp, use permissions of 755 for directories and 644 for files.
