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

Jump to: navigation, search
(for install AND for upgrade)
 
m (Reverted edits by Oxlo (talk) to last revision by Chainy)
Tag: Rollback
 
(32 intermediate revisions by 10 users not shown)
Line 1: Line 1:
==Set File 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 files is either 777, 775 or 755, 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 {{ucfirst:{{{1|install}}}}}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 {{lc:{{{1|install}}}}}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 {{lc:{{{1|install}}}}}er. For example: www.yourdomain.com/forum/{{lc:{{{1|install}}}}}.php. If the {{lc:{{{1|install}}}}}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 may not work on some servers.


===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 should have <b>CHMOD</b> values of 777, 775 or 755:
===Setting File Permissions with the {{#switch: {{lc:{{{1|install}}}}}|install=Install|upgrade=Upgrad}}er===
*/attachments
 
*/avatars
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.
*/Packages
 
*/Packages/installed.list
===Setting File Permissions with FTP===
*/Smileys
 
*/Themes
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.
*/Themes/default/languages/Install.english.php
</includeonly><noinclude>{{Documentation}}</noinclude>
*agreement.txt
*Settings.php
*Settings_bak.php
*{{lc:{{{1|install}}}}}.php

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: