Install Kirby on a sub folder on a live domain

Hi guys, I hope you can help a noob like me. I have downloaded the Plain starter pack, I have to say that out of the box there are no .htaccess file in my unzipped folder (and yes I made sure that the hidden file is shown).

Next, I did login using FileZilla to my FTP server created a new folder in the root called kirby and uploaded all the files that were in the Plain starter pack zip file.

Now I’m trying to access the homepage sort of speak by going to: and I only get this:

Also If I try to access the panel which from the doc it should be - I get 404 - page not found.

Any assistance would really be appreciated.

Looks like you didn’t upload the .htaccess file which is part of the Plainkit zip ( I just downloaded it myself to check, so it’s definitely there).

Thanks a lot for your reply, I was going to update this topic. For some reasons the command in mac os to show hidden file didn’t work, however when I did browse the unzipped file using FileZilla I did saw the .htaccess file.

So I was able to browse the panel once I was there I get a different issue searching the forum I found that in site/config/config.php I should add a line of code. The problem was that the cofing folder was totally missing.

I have created the config folder inside the site folder, created the config.php file and placed this PHP code:


return [
    'debug'  => true,
    'panel' => true,
    'panel.install' => true

To bad I didn’t find this information in the troubleshooting guide. I mean not everyone would install even the test version on a local set-up, so I think general information on how to set this up on a live server and even in a sub-folder with all the steps that a user (new ) should take should really be easy to find.

Anyway, thanks for your quick response.

1 Like

You are right, that’s missing, I created an issue to add this information to the installation guide.

Even though this topic is super old, I am having the same issue:

I could now find the .htaccess file and uploaded it.

But all I get is a “404 Not Found”.

When trying to access any link but the homepage, I guess.

Are you on an Apache server at all?
If yes, if you put any rubbish into the .htaccess, do you get an error or same behavior as before?
If you don’t get an error, the .htaccess is simply ignored.

Bildschirmfoto 2023-11-23 um 19.15.29

What am I supposed to put into the .htaccess?

Wait, could you be more elaborate, please and answer all question.

The error we are seing here already appears on the startpage. Only after adding something to .htacess or already before?

If the error already happens on the homepage before you added rubbish to the .htaccess, then the problem is not due to a missing htaccess file.

Yes, I am on an Apache server.

I did not add anything to .htaccess – including not adding rubbish. The instructions did not mention adding anything to .htaccess, so I didn’t. So, to answer your question: already before.

Well, let’s test something simple. Remove the kirby project again and just put an index.php with just a simple php echo statement in there.

1 Like

Thank you for the consistent replies.

I am slowly getting there. Now, I get a screen from Kirby that says that my website is currently offline. The panel-link does the same:

This page is currently offline. We are very sorry for the inconvenience and will fix it as soon as possible. Advice for developers and administrators: Change the PHP version to one supported by your version of Kirby

Any advice? In my settings, it says the PHP configuration now is 8.0

/// I have now figured it out with the instructions @eduard-ungureanu mentioned above!