Template:Set file permissions: Difference between revisions From Online Manual

Jump to: navigation, search
(added documentation)
m (Reverted edits by Oxlo (talk) to last revision by Chainy)
Tag: Rollback
 
(17 intermediate revisions by 5 users not shown)
Line 1: Line 1:
<includeonly>==Set File/Folder Permissions==
<includeonly>==Set File and Directory Permissions==
After the {{lc:{{{1|install}}}}} archive has been uploaded and extracted, you need to set the files' permissions. This is commonly done by use of the Unix utility <b>CHMOD</b>. 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. <br />


===Setting File Permissions With the {{#switch: {{lc:{{{1|install}}}}}|install=Install|upgrade=Upgrad}}er===
File and directory permissions control who can see your files and use your directories. They can control whether you will be able to install [[Modifications|mods]] to your forum. On Linux and other Unix-like servers the [[chmod|chmod command]] is used to designate permissions. On most servers, a setting of 755 for directories and 644 for files will work. If this does not work on your hosting service, you may need 777 or 775 for directories, and 666 or 664 for files. Some hosts do not allow using 777 for directories or 666 for files -- using such high values will cause Internal Server Errors, 500 erors, or other errors. If the permission on your files or directories does not make them writable, the SMF {{#switch: {{lc:{{{1|install}}}}}|install=install|upgrade=upgrad}}er will report the problem -- if it can detect it.
The SMF {{#switch: {{lc:{{{1|install}}}}}|install=install|upgrade=upgrad}}er can set file permissions simply and easily. Navigating to the directory where SMF is located should redirect you to the {{lc:{{{1|install}}}}}.php file and prompt the {{#switch: {{lc:{{{1|install}}}}}|install=install|upgrade=upgrad}}er. For example: www.yourdomain.com/forum/{{lc:{{{1|install}}}}}.php. If the {{#switch: {{lc:{{{1|install}}}}}|install=install|upgrade=upgrad}}er detects files that need their permissions adjusted it will prompt for FTP details so it can <b>CHMOD</b> the files it requires for the {{lc:{{{1|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===
'''Note:''' If a Windows server is being used rather than a Linux server, then you will need to contact your host to change the file/directory permissions.
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 <b>CHMOD</b> values of 644, 664 or 666 for files, and 755, 775 or 777 for folders:
===Setting File Permissions with the {{#switch: {{lc:{{{1|install}}}}}|install=Install|upgrade=Upgrad}}er===
*/attachments
*/avatars
*/Packages
*/Packages/installed.list
*/Smileys
*/Themes
*/Themes/default/languages/Install.english.php
*agreement.txt
*Settings.php
*Settings_bak.php
*{{lc:{{{1|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.
In many cases, the SMF {{#switch: {{lc:{{{1|install}}}}}|install=install|upgrade=upgrad}}er can handle this for you. If you want to give this a try, skip this step for now, and wait until you come to the appropriate point in the {{#switch: {{lc:{{{1|install}}}}}|install=install|upgrade=upgrad}}er. The {{#switch: {{lc:{{{1|install}}}}}|install=install|upgrade=upgrad}}er might need to ask you for FTP login details to get the job done, so be sure to make a note of them. If you run into any problems setting file permissions with the {{#switch: {{lc:{{{1|install}}}}}|install=install|upgrade=upgrad}}er, you can use the instructions below for setting file permissions with FTP to handle it yourself.


'''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.
===Setting File Permissions with FTP===


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.</includeonly><noinclude>{{Documentation}}</noinclude>
Using a control panel or [[FTP_-_How_do_I_use_FTP|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.
</includeonly><noinclude>{{Documentation}}</noinclude>

Latest revision as of 09:58, 23 April 2022

[edit] [purge] Template documentation

This template is meant to be included in articles on installing and upgrading, to provide the information about CHMOD/file permissions. To see it in action, please look at the testcases, or at Special:WhatLinksHere/Template:Set_file_permissions

Examples:

{{Set file permissions|install}}
{{Set file permissions|upgrade}}
  • install the word "install" will be inserted at several key points
  • update the word "update" will be inserted at several key points


Advertisement: