We try our best to make the installation of Kirby as effortless as possible, but with multiple server setups and PHP versions, there's unfortunately always space for problems.
Your homepage is working great, but subpages won't open or lead to a server error?
- Make sure that the
.htaccessfile that ships with Kirby is present in your Kirby folder.
- Check if
mod_rewriteis enabled on your server (Apache).
- Check if the
.htaccessfile gets loaded. You can test this by putting some nonsense characters into your
.htaccess. If this triggers an "Internal Server Error", the file gets loaded. Otherwise, you need to enable
AllowOverride allin your Apache configuration.
- Please try setting the
If you run Kirby in a subfolder, make sure to set the RewriteBase according to the name of your subfolder:
If you use PHP's built-in server (not recommended), you have to start it up with Kirby's router:
php -S localhost:8000 kirby/router.php
Please make sure that you use the minimum required version of PHP, which is 7.1+ since Kirby 3.0.0. We recommend using the most recent stable PHP version that is available to you.
Your content files seem to be corrupted after you tried to save a page in the Panel? Make sure the PHP
mb_string extension is installed on your server. A missing extension leads to broken data in text files.
Make sure that the PHP
mb_string extension is installed/enabled.