For Books, Library and Map. You have never used a server? Start here. You do not need to know how servers work. Each step says what to click and why.
You bought the template: the design, the Panel setup and the demo content. Unzipped, it is one folder: kirby-books-template, kirby-library-template or kirby-map-template.
Kirby itself is not inside. Kirby is the software that runs the site and the Panel (the admin screens where you edit). Kirby’s licence does not allow us to include it. So you download it from Kirby’s makers. The download is free.
Every host uses these words. Learn these eight now. The rest are below, for when you need them.
example.com. You pay each year for the right to use it. You never own it outright.localhost:8000 opens the site running on it..htaccess uses to give every page a clean address. Kirby needs it.gd (images) and mbstring (text). The host turns them on.644 for files and 755 for folders.203.0.113.10. Your host gives it to you.www, to another name.No command line. You copy one folder.
kirby-books-template.5. As of October 2026 that is 5.6.1.plainkit-5.6.1. Inside is a folder named kirby.kirby folder into your template folder, next to index.php. You do not need the rest of the Plainkit..htaccess, open File Explorer and choose View → Show → Hidden items..htaccess is in the template folder. On the server it keeps your content and your login files private. Never delete it.kirby-books-template/ ├── .htaccess ← hidden file. It must be here. ├── index.php ├── router.php for trying it on your computer ├── composer.json ├── INSTALL.txt ├── HOSTING.md this guide ├── README.md ├── LICENSE ├── assets/ ├── content/ your texts and images ├── kirby/ ← the folder you just copied in │ ├── bootstrap.php │ ├── vendor/ │ └── … ├── site/ │ ├── accounts/ empty until step 3 │ ├── config/ │ └── … └── … a few more small files
A few small files differ between Books, Library and Map. That is normal.
Common mistake. Don’t copy the whole Plainkit folder. If the path reads kirby-books-template/plainkit-5.6.1/kirby, move the kirby folder up one level, so it reads kirby-books-template/kirby.
Kirby 5, not 6. These templates are built for Kirby 5. Kirby 6 is in beta (as of October 2026, Kirby releases). As of October 2026, the Plainkit button on Kirby’s quickstart page also gives 5.6.1, but that may change once Kirby 6 is final. The tags page always lets you pick a 5.x version.
If you use Composer, run this inside the template folder. It puts Kirby into kirby/ for you.
composer install
The template’s composer.json asks for Kirby ^5.6, so it never installs Kirby 6.
Do this first. It costs nothing. It is also the easiest place to create your Panel login: on a public server Kirby blocks that step (step 6 explains why).
Use PHP 8.4 (8.2, 8.3 or 8.5 also work). Never 8.6. As of October 2026, PHP 8.6 is in testing and will come out soon (php.net). Kirby 5 refuses it and shows “This page is currently offline”. Some tools and hosts install the newest PHP by default, so check the number wherever you see a PHP list.
There are three ways to run the site on your computer. Pick one. STstudio tests the templates with C, PHP’s own small server, which the template’s router.php is made for. A and B are apps with buttons, and Kirby’s quickstart suggests A. We have not tested the templates in A or B yet (October 2026). If your site does not appear there, use C on a Mac, or the other app on Windows.
Herd folder is there. On Windows: the Herd folder is in your user folder.http://kirby-books-template.test in your browser: the folder name plus .test.localhost address MAMP shows.Terminal and press Return. (It is also in Applications → Utilities.)brew install php@8.4Not
brew install php: that one follows the newest PHP and will move to 8.6.cd and a space, drag the folder from Finder into the Terminal window, and press Return."$(brew --prefix php@8.4)/bin/php" -S localhost:8000 router.php
The command is long because Homebrew does not make php@8.4 the plain php command. Plain php gives “command not found”, or runs a different version.
This server is for your own computer only. PHP’s makers say it should not be used on a public network.
/panel to the address, for example http://kirby-books-template.test/panel or http://localhost:8000/panel.site/accounts/. There is one folder per login, with a hidden file inside, .htpasswd, that holds your password.Keep site/accounts/. You will upload it with everything else, hidden files included. That is the simplest and safest way to have a login on your live site.
The template guides show the Panel screens: Books, Library, Map.
You need a host that runs PHP. Many cheap and free hosts do not.
.htaccess files and mod_rewrite (URL rewriting)?gd, mbstring and curl turned on? (The full list is on Kirby’s requirements page.)Copy the five questions into a message to the host’s support. Asking before you pay is the cheapest way to find out.
Skip one-click Kirby installers. Some hosts offer to install Kirby for you. That gives you an empty Kirby, not your template. Upload your own template folder instead (step 5).
These are examples, not recommendations. Prices and versions are as of October 2026: check them yourself.
Kirby’s list of hosts with their own Kirby guide also names fortrabbit, Uberspace and RoseHosting. Their guides cover an old platform, are marked as broken, or need the command line, so they are not for beginners.
id.mycafe24.com) cannot have HTTPS..htaccess with mod_rewrite is allowed, and whether the file manager can unzip. Ask Cafe24..htaccess with mod_rewrite, and unzipping in the file manager. Ask Gabia.public_html, www or htdocs. Your host’s control panel or welcome message tells you which. On shared hosting you usually cannot pick another folder.index.html, ask your host whether you can delete them, then delete them. Otherwise the host’s page may show instead of your site.router.php and the text files. They do no harm on the server: there, .htaccess stops router.php from running.Right Wrong public_html/ public_html/ ├── .htaccess └── kirby-books-template/ ├── index.php ├── .htaccess ├── router.php ├── index.php ├── assets/ └── … ├── content/ ├── kirby/ ├── site/ └── … every other file
In the wrong version, the site lives at example.com/kirby-books-template/ and its pages may not open.
.htaccess, index.php, assets/, content/, kirby/ with kirby/vendor/ inside, and site/accounts/ with your login folder inside. That folder must hold the hidden file .htpasswd (your password). Without it, your correct password is refused. The kirby folder has nearly a thousand files, so give it time.You do not need to upload media/ if your computer made one. Kirby makes it again on the server.
Choose SFTP rather than plain FTP when the host offers both. SFTP is the more secure of the two.
FileZilla (filezilla-project.org) works too. Turn on Server → Force Showing Hidden Files before you connect.
Cafe24: your address, user and port are under 나의 서비스 관리 > 호스팅관리 > 서비스 접속관리 > FTP. SFTP is usually port 22 and FTP port 21. Some older accounts use another port, so use the one that page shows. (Cafe24 help)
Open the file manager in your host’s control panel and go to the document root.
If it can unzip files (ask your host), this is faster: open your template folder, show hidden files, select everything inside it, .htaccess too, and compress it into one zip. Upload that zip into the document root and unzip it there. Then delete the zip.
If it cannot unzip, upload the files and folders as they are. Make sure the hidden .htaccess and .htpasswd go too.
Kirby must be able to write to some folders: content/, site/accounts/, site/cache/, site/sessions/ and media/ (Kirby creates it). Kirby’s advice: files 644, folders 755.
Most hosts get this right on upload. If Kirby later says a folder “does not exist or is not writable”, change the permissions in your SFTP app or file manager, or ask the host to do it.
/panel to the address. If you see the host’s own “Not Found” page instead of the Panel, see “Only the home page works” in step 9./content/site.txt to the address. You should see your site’s error page, not plain text. If you see text, .htaccess is not working and anyone can read your files. Stop there and ask the host to turn on .htaccess and mod_rewrite..htpasswd did not arrive: show hidden files in your SFTP app and upload site/accounts/ again.Kirby may show this message instead of a login:
The panel installer is disabled on public servers by default. Please run the installer on a local machine or enable it with the panel.install option.
This is not about HTTPS. Kirby blocks creating the first account on every public server. Without that rule, a stranger could open your Panel first and make themselves the administrator.
The safe way round it: create the account on your computer (step 3), then upload the site/accounts/ folder with hidden files shown. Then reload /panel and log in.
site/config/config.phpYou need this for the installer switch below, the url line in step 7 and the debug line in step 9.
site/config/ on the server.site/config/ on the server, and let it replace the old one.Do this only if you cannot use your computer, and preferably after HTTPS works (step 7). Over plain http://, your new password travels unencrypted.
site/config/config.php (how: see above), add the two new lines right after return [:
<?php
return [
// Remove the next line after you log in:
'panel' => ['install' => true],
'debug' => false,
…/panel at once. While the line is there, whoever opens /panel first becomes the administrator.Source: Kirby — panel options.
Bought from your host: it is usually connected for you. If not, add it in the host’s domain menu.
Bought somewhere else: there are two ways. If this is new to you, choose the first.
A record: name @ (some companies leave it blank), value: the server’s IP address from your host.CNAME record: name www, value example.com (or the name your host gives).Then wait. DNS record changes usually show up in 30 minutes to an hour, but can take up to 48 hours (Cafe24 help). Nameserver changes can take 24–48 hours (Cafe24 help).
Using email on this domain? Note down its mail records (MX and the others) before you change the nameservers. You will need to create them again at the new host, or your email stops.
https:// plus your domain. Look for the padlock.https://, turn it on.http://, or show the temporary address, tell Kirby the right address. In site/config/config.php (how to edit it), add this line right after return [, with your own domain:
'url' => 'https://example.com',(Kirby — url option)
Any public site needs a paid Kirby licence, even a personal, non-commercial one. Working on your own computer is free. So is a preview that only a small group can reach, such as a password-protected test site: since Kirby 5.5 it can use a free development licence.
As of October 2026: getkirby.com/buy, getkirby.com/license. These are Kirby’s terms, not ours. Kirby sells the licence, not STstudio.
Upload the file into site/config/ on the server first. Then rename it to .license in your SFTP app or the host’s file manager. Don’t rename it on your Mac: Finder may refuse names that start with a dot.
Now replace the demo content with your own. The template guides show how: Books, Library, Map.
Find what you see, then read why and what to do.
| What you see | Why | What to do |
|---|---|---|
| Your host’s welcome page, not your site | The host’s own start file, such as index.html, is still in the document root. | Ask your host whether you can delete it, then delete it (step 5). Check that your files are in the document root itself. |
| Plain text: “Kirby core is not installed yet, or it is incomplete.” (error 500) | The kirby folder is missing, or kirby/vendor/ did not finish uploading. | Add Kirby (step 2). Upload the whole kirby folder again. |
| “This page is currently offline … Change the PHP version …” (error 503) | A PHP version Kirby 5 does not accept: below 8.2, or 8.6 and up. | Choose PHP 8.4 (or 8.2–8.5) in the host’s control panel, or in Herd or MAMP. On Cafe24, read the warning in step 4 first. |
| Odd PHP “syntax errors” | The wrong PHP version. | Choose PHP 8.4. |
| A blank page, or a general error page | A PHP error. The templates ship with debug mode off, so the message is hidden. | Read the PHP error log in your host’s control panel, or ask the host. Or set 'debug' => true in site/config/config.php (how) for a minute, read the message, then set it back to false at once. Kirby warns that showing errors on a public server is a serious security risk. |
Only the home page works. Other pages and /panel show “Not Found”. | .htaccess is missing (hidden files were not shown when you uploaded), or mod_rewrite is off, or the site sits in a subfolder. | Show hidden files and upload .htaccess. Ask the host to turn on mod_rewrite and AllowOverride All. Upload the folder’s contents into the document root (step 5), or ask the host about RewriteBase for a subfolder. |
/content/site.txt shows plain text | .htaccess is not working, so your files can be read directly. | Same as above, and do it now. |
| “The panel installer is disabled on public servers by default.” | Kirby blocks creating the first account on any public server. Not an HTTPS problem. | Create the account on your computer and upload site/accounts/ (step 6). |
| Kirby refuses your correct password | The hidden .htpasswd file in site/accounts/ did not arrive. | Show hidden files in your SFTP app and upload site/accounts/ again (step 5). |
“The /site/accounts folder does not exist or is not writable” (or /content, /media, /site/sessions) | The folder is missing, or Kirby may not write to it. | Upload the folder. Set permissions (step 5), or ask the host. |
| “The CURL extension is required” or “The MB String extension is required” | A PHP extension is turned off. | Ask the host to turn it on. |
| Error 500 in the Panel, or saved text comes out garbled | The mbstring extension is missing. | Ask the host to turn on mbstring. |
| The Panel cannot save your changes | Kirby may not write to content/. | Make content/ and its folders writable (step 5). |
| Images or thumbnails do not appear | Most often media/ is not writable. Or the gd extension is missing. | Make media/ writable. Ask the host for gd. |
Links start with http://, or show the wrong address | Kirby guesses the address from the server, and sometimes guesses wrong. | Set the url option to your https:// address (step 7). |
| Dates or times are off | The server’s time zone setting (date.timezone). | Ask the host to set it. |
| The domain does not open yet | DNS is still updating. | Wait up to 48 hours. Check the nameservers or records (step 7). |
| No padlock, or the browser warns about the connection | The certificate is not issued yet, or your plan or domain is not covered. | Turn it on in the control panel. Ask the host whether your domain is covered (see the Cafe24 rules in step 4). |
| The Panel looks broken | An old browser. | Use Safari 16+, Chrome or Edge 106+, or Firefox 110+. |
Based on Kirby’s installation troubleshooting and thumbnail troubleshooting pages.
Still stuck? Write to STstudio with the contact form at ststudio.co.kr/en/about: choose “Something else”. Say which template you have, which step you are on and what you see. For questions about your order or download, use “Contact the seller” on your Gumroad receipt.
Once the site is live, edit only in the live Panel. The copy on your computer is now out of date. Don’t upload content/ or site/accounts/ from your computer again unless you mean to replace what is online. Download first.
Download these from the server to your computer regularly, and always before a change:
content/ — all your texts and images.site/accounts/ — your Panel logins (hidden files included).site/config/.license — your Kirby licence (a hidden file).site/ and assets/ too, if you changed the templates or styles.Do not rely on the host’s backups alone. On Cafe24, for example, changing the PHP version deletes them.
The templates ship with 'debug' => false. Keep it that way on the live site. If you added the 'panel' => ['install' => true] line, make sure it is gone.
PHP versions stop getting security fixes: 8.2 on 31 December 2026, 8.3 on 31 December 2027, 8.4 on 31 December 2028, 8.5 on 31 December 2029 (as of October 2026, php.net). So choose 8.4. Do not let the host, or Herd, move you to 8.6 while you are on Kirby 5. Back up before any PHP change.
5. (step 2). Replace your kirby folder with its kirby folder.media folder. Kirby makes it again.kirby folder to kirby-old. Upload the new kirby folder and delete media/. Check the site, then delete kirby-old straight away: .htaccess only guards the folder named kirby.Stay on Kirby 5 for these templates. Kirby 6 (in beta as of October 2026) needs PHP 8.3–8.5 (Kirby 6 beta requirements) and has not been tested with them.
Source: Kirby — installation via download.