Installation"

This website contains links to software which is either no longer maintained or will be supported only until the end of 2019 (CKFinder 2). For the latest documentation about current CKSource projects, including software like CKEditor 4/CKEditor 5, CKFinder 3, Cloud Services, Letters, Accessibility Checker, please visit the new documentation website.

If you look for an information about very old versions of CKEditor, FCKeditor and CKFinder check also the CKEditor forum, which was closed in 2015. If not, please head to StackOverflow for support.

(Article contents proof-read and formatted)
Line 1: Line 1:
 
== Installation Instructions ==
 
== Installation Instructions ==
  
−
# Copy the distribution files to your web server inside the "/ckfinder/" folder or any other folder in your web site.
+
# Copy the distribution files to your Web server and place them inside the <code>/ckfinder/</code> folder or any other folder of your website.
−
# Create a folder in the server to hold all uploaded files. By default, CKFinder is configured to use the "/ckfinder/userfiles/" folder in your web site.
+
# Create a folder on the server to store all uploaded files. By default, CKFinder is configured to use the <code>/ckfinder/userfiles/</code> folder of your website.
−
# Make the above user files folder writable by the internet user. On Windows, give write permissions to the IUSR_&lt;ServerName&gt; user. On Linux, chmod it to 0777. '''NOTE:''' usually setting permissions to 0777 is insecure, it is advisable to change the group ownership of the directory to the same user as apache and add group write permisions instead. Please contact your system administrator in case of any doubts.
+
# Make the user files folder mentioned in point 2 writable for the Internet user. For a Windows system give write permissions to the <code>IUSR_&lt;ServerName&gt;</code> user. For Linux chmod it to <code>0777</code>.  
−
# Edit the '''config.php''' file. Be sure you have correctly set all settings in that file, and that you have enabled CKFinder on it. See [[CKFinder_2.x/Developers Guide/PHP/Configuration|Configuration]]<br>
+
#; '''NOTE:''' since usually setting permissions to <code>0777</code> is insecure, it is advisable to change the group ownership of the directory to the same user as Apache and add group write permisions instead. Please contact your system administrator in case of any doubts.
−
# Make sure that PHP is configured properly: GD extension should be enabled and safe mode should be disabled.
+
# Edit the <code>config.php</code> file. Make sure you set all settings in that file correctly, and that you enabled CKFinder. See [[CKFinder_2.x/Developers Guide/PHP/Configuration|Configuration]] for more information.
 +
# Make sure that PHP is configured properly &mdash; GD extension should be enabled and safe mode should be disabled.
  
−
You should be ready to go. Just browse _samples/php/standalone.php to test and see CKFinder.
+
You should be ready to go. Just browse to the <code>_samples/php/standalone.php</code> page to test and see CKFinder.
  
 
== Security Tips ==
 
== Security Tips ==
−
 
+
* On Apache you may disable the PHP engine in the user files folder. If you chose a different user files folder, copy the <code>/ckfinder/userfiles/.htaccess</code> file with these settings from the its default location and paste it into your destination folder.
−
* On Apache, you may disable the PHP engine in the user files folder by copying the "/userfiles/.htaccess" file inside your destination folder.
+
* The <code>config.php</code> file contains many important security settings. You need to be positive that you have reviewed and understood all of them before you enable CKFinder on your website.
−
* The config.php file contains many important security settings. Be sure you have reviewed and understood all of them.
+
* For more security tips see the [[CKFinder_2.x/Developers Guide/PHP/Configuration/Security|Security]] section.
−
* For more security tips see [[CKFinder_2.x/Developers Guide/PHP/Configuration/Security|Security]] section.
 

Revision as of 13:20, 14 July 2011

Installation Instructions

  1. Copy the distribution files to your Web server and place them inside the /ckfinder/ folder or any other folder of your website.
  2. Create a folder on the server to store all uploaded files. By default, CKFinder is configured to use the /ckfinder/userfiles/ folder of your website.
  3. Make the user files folder mentioned in point 2 writable for the Internet user. For a Windows system give write permissions to the IUSR_<ServerName> user. For Linux chmod it to 0777.
    NOTE: since usually setting permissions to 0777 is insecure, it is advisable to change the group ownership of the directory to the same user as Apache and add group write permisions instead. Please contact your system administrator in case of any doubts.
  4. Edit the config.php file. Make sure you set all settings in that file correctly, and that you enabled CKFinder. See Configuration for more information.
  5. Make sure that PHP is configured properly — GD extension should be enabled and safe mode should be disabled.

You should be ready to go. Just browse to the _samples/php/standalone.php page to test and see CKFinder.

Security Tips

  • On Apache you may disable the PHP engine in the user files folder. If you chose a different user files folder, copy the /ckfinder/userfiles/.htaccess file with these settings from the its default location and paste it into your destination folder.
  • The config.php file contains many important security settings. You need to be positive that you have reviewed and understood all of them before you enable CKFinder on your website.
  • For more security tips see the Security section.
Retrieved from "https://docs-old.ckeditor.com/index.php?title=CKFinder_2.x/Developers_Guide/PHP/Installation&oldid=6402"