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.

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.