Kirby 5 Templates  ·  STstudio

Getting your template online — from zero

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.

00 What you bought, and what you will need

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.

A computer
A Mac or a Windows PC.
Time
About 30–60 minutes to get the site running on your computer. Putting it online is a few more steps, plus some waiting: a domain change can take up to 48 hours.
Hosting
A monthly or yearly fee to a host. Examples in step 4.
Domain
A yearly fee to a domain company. Some hosts give you a free temporary address, so you can start without one.
HTTPS
Often free. Some hosts charge a setup fee, or give it free only for domains bought from them.
Kirby licence
Only when the site goes public: a one-time fee per site, paid to Kirby, not to STstudio. Current prices: getkirby.com/buy. Working on your own computer is free for as long as you like.

01 The words you will meet

Every host uses these words. Learn these eight now. The rest are below, for when you need them.

Server
A computer that is always on and connected to the internet. It hands your pages to every visitor.
Hosting
Renting space on someone else’s server. The company you rent from is the host.
Control panel
The website where you manage your hosting: PHP version, domain, HTTPS, files.
PHP
The programming language Kirby is written in. Your host must run it. Kirby 5 works with PHP 8.2, 8.3, 8.4 and 8.5, and Kirby recommends 8.4 (as of October 2026, Kirby 5.6.1: requirements). Choose 8.4.
Domain
Your address, like example.com. You pay each year for the right to use it. You never own it outright.
DNS
The internet’s address book. It tells browsers which server belongs to your domain.
HTTPS
The encrypted version of a web connection: the padlock in the address bar. It needs a certificate, often called an SSL certificate.
SFTP
A secure way to copy files from your computer to the server, using an app such as Cyberduck. A host’s file manager does the same job in your browser.
More words, for later steps
localhost
Your own computer, as your browser sees it. localhost:8000 opens the site running on it.
Terminal
The Mac app where you type commands. It is in Applications → Utilities.
Document root
The folder on the server that holds your website. Step 5 shows how to find it.
Port
A number your SFTP app needs to connect. Your host gives it to you.
Apache
The web server software most shared hosts run. Kirby works with it as it is.
.htaccess
A hidden settings file for Apache, in your template folder. It keeps your private files private.
mod_rewrite
The Apache feature that .htaccess uses to give every page a clean address. Kirby needs it.
PHP extensions
Add-ons for PHP, such as gd (images) and mbstring (text). The host turns them on.
Permissions
Who may read and change a file or folder. Written as numbers, such as 644 for files and 755 for folders.
IP address
The server’s number on the internet, such as 203.0.113.10. Your host gives it to you.
Nameservers
The servers that answer for your domain. They tell the internet where your site and your email are.
A record
A line in the DNS that points your domain to the server’s IP address.
CNAME record
A line in the DNS that points one name, such as www, to another name.
MX record
A line in the DNS that says where your domain’s email goes.

02 Add Kirby to the template

No command line. You copy one folder.

  1. Unzip your template. You get a folder, for example kirby-books-template.
  2. Download the Kirby 5 Plainkit, a small empty Kirby site. Go to github.com/getkirby/plainkit/tags and click zip under the newest tag (a numbered version) that starts with 5. As of October 2026 that is 5.6.1.
  3. Unzip it. You get a folder like plainkit-5.6.1. Inside is a folder named kirby.
  4. Copy only that kirby folder into your template folder, next to index.php. You do not need the rest of the Plainkit.
  5. Show hidden files. On a Mac, names that start with a dot are hidden. In Finder, press ⌘ Shift . (Command, Shift and the full stop). Press it again to hide them. On Windows, if you don’t see .htaccess, open File Explorer and choose View → Show → Hidden items.
  6. Check that .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.

For developers: Composer instead of the Plainkit

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.

03 Try it on your computer, and create your Panel login there

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.

A. Laravel Herd (free, Mac or Windows)

  1. Download Herd from herd.laravel.com and install it. The free version needs no licence.
  2. Check Herd’s PHP version. Open Herd’s menu (its icon in the menu bar on a Mac, in the system tray on Windows) and look at the PHP list. Herd comes with PHP 8.5 (as of October 2026, Herd docs). 8.5 works, and so does 8.4. If the list shows 8.6 instead, open Herd’s settings, go to PHP and install 8.4. Then choose 8.4 in Herd’s menu.
  3. Move your template folder into Herd’s folder. On a Mac: in Finder, choose Go → Home. The Herd folder is there. On Windows: the Herd folder is in your user folder.
  4. Open http://kirby-books-template.test in your browser: the folder name plus .test.

B. MAMP (free, Mac or Windows)

  1. Download MAMP from mamp.info and install it.
  2. In MAMP’s settings, choose PHP 8.4, or another version from 8.2 to 8.5. Not 8.6.
  3. In the settings, point MAMP at your template folder. MAMP calls this the document root.
  4. Start the servers, then open the localhost address MAMP shows.

C. Terminal on a Mac (the way STstudio tests the templates)

  1. Open Terminal. Press ⌘ Space, type Terminal and press Return. (It is also in Applications → Utilities.)
  2. Install Homebrew, a free tool that installs software. On brew.sh, copy the one-line command, paste it into Terminal and press Return. Type your Mac password when asked: nothing appears as you type, which is normal. It can take several minutes. If it ends with “Next steps” and some commands, copy those into Terminal too and press Return, or Terminal will not find Homebrew.
  3. Install PHP 8.4. Paste this and press Return:
    brew install php@8.4
    Not brew install php: that one follows the newest PHP and will move to 8.6.
  4. Go into your template folder. Type cd and a space, drag the folder from Finder into the Terminal window, and press Return.
  5. Start the server. Paste this and press Return:
    "$(brew --prefix php@8.4)/bin/php" -S localhost:8000 router.php
  6. Open localhost:8000 in your browser. To stop the server, press Ctrl + C in Terminal. To start it again later, repeat steps 4 and 5.

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.

Create your Panel login

  1. Add /panel to the address, for example http://kirby-books-template.test/panel or http://localhost:8000/panel.
  2. Kirby asks for an email address and a password. This makes you the administrator. There is no account with Kirby or with STstudio: the login is saved as files in your template folder, in site/accounts/. There is one folder per login, with a hidden file inside, .htpasswd, that holds your password.
  3. Change one thing, for example a title, and reload the site to see it. Your setup works.

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.

04 Choose hosting

You need a host that runs PHP. Many cheap and free hosts do not.

Works
Linux shared hosting with PHP and Apache (“shared” means you share one server with other customers). Kirby says Apache works out of the box. Managed PHP hosting works too. A VPS (your own rented server) works only if you know how to run a server.
Does not work
Static hosts such as GitHub Pages and Netlify. They send ready-made files and do not run PHP (GitHub docs; Netlify forum).
Vercel. It can run PHP in some setups, but its disk is read-only apart from a temporary folder. What you save in the Panel (texts, images, your login) would be lost.
Windows hosting (plans for ASP or IIS). Kirby needs a Unix-like server.

Ask the host these five questions before you pay

  1. Can I use PHP 8.4? (8.2, 8.3 or 8.5 also work. Not 7.x, and not 8.6.)
  2. Does the server use Apache with .htaccess files and mod_rewrite (URL rewriting)?
  3. Are the PHP extensions gd, mbstring and curl turned on? (The full list is on Kirby’s requirements page.)
  4. Can I upload by SFTP, or with a file manager? Can the file manager unzip a zip file?
  5. Is the HTTPS certificate free for a domain I bought somewhere else? Is there a setup fee?

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).

Examples

These are examples, not recommendations. Prices and versions are as of October 2026: check them yourself.

alwaysdata (on Kirby’s list of hosts)
  • Promises free HTTPS. Free plan: 1 GB disk, €0. Small plan: 50 GB, €6 a month excl. tax (alwaysdata.com).
  • Its Marketplace installs a new, empty Kirby. Don’t use it: upload your template (step 5).
  • You still need a Kirby licence once the site is public.

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.

카페24 Cafe24 (Korea)
  • Choose PHP 8.4 when you order 뉴아우토반 hosting. The choices are 8.4, 8.2 and 7.4. Changing it later deletes all your files and the database, including the 7-day backups. (Cafe24 help)
  • “SSL Basic”: no yearly fee, but a one-time 11,000 원 setup fee (VAT included). It works only on some PHP 8 plans (단독웹호스팅 클라우드, 뉴아우토반, 10G 광아우토반 FullSSD+). It also needs a domain bought at Cafe24 that uses Cafe24’s nameservers. Domains in Korean characters are excluded. One Cafe24 page lists only 10G 광아우토반 FullSSD+, so confirm it for your plan. (Cafe24 SSL)
  • A domain bought elsewhere needs a paid certificate, from 38,500 원 a year, or a move of the domain to Cafe24.
  • The free temporary address (id.mycafe24.com) cannot have HTTPS.
  • Most Linux plans offer SFTP. Windows hosting, 무제한 광호스팅 and image hosting offer FTP only.
  • Not confirmed: whether .htaccess with mod_rewrite is allowed, and whether the file manager can unzip. Ask Cafe24.
가비아 Gabia (Korea)
  • Choose the Linux (PHP) plan. The Windows plans (ASP/IIS) will not work.
  • Plans come with PHP 7.3 by default, which Kirby refuses. Switch to 8.4 (or 8.5). 8.2 and 8.3 are not offered. Ask Gabia how to change it on your plan.
  • Linux plans run Apache 2.4 and offer SSH, FTP and SFTP.
  • Linux 베이직: 4,950 원 a month. Setup fee: 11,000 원, or 33,000 원 with a domain from another company. (Gabia spec table)
  • Not confirmed: a free certificate (the spec table only says port 443 is provided), .htaccess with mod_rewrite, and unzipping in the file manager. Ask Gabia.

05 Upload the files

  1. Find your document root. That is the folder on the server that holds your website. It is often called 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.
  2. Clear out the host’s files. If the document root already has files from the host, such as index.html, ask your host whether you can delete them, then delete them. Otherwise the host’s page may show instead of your site.
  3. Upload everything inside your template folder, not the folder itself. That includes 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.

  1. Copy the files with an SFTP app or the host’s file manager (details below). Use the server address, user name, password and port your host gives you. Turn on hidden files first, in your SFTP app and in Finder or File Explorer.
  2. Check that everything arrived: .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.

With an SFTP app: Cyberduck (or FileZilla)

Choose SFTP rather than plain FTP when the host offers both. SFTP is the more secure of the two.

  1. Install Cyberduck (cyberduck.io, Mac and Windows). Turn on View → Show Hidden Files.
  2. Click Open Connection. In the menu at the top of the window, choose SFTP (SSH File Transfer Protocol).
  3. Fill in the server, port, username and password your host gave you. Click Connect.
  4. Double-click your document root to open it.
  5. Open your template folder in Finder (hidden files shown) or File Explorer. Select everything inside it (⌘ A, or Ctrl + A on Windows) and drag it into the Cyberduck window. Or use File → Upload.

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)

With the host’s file manager

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.

About permissions (who may change which files)

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.

06 First visit and Panel login

  1. Open the address your host gave you: the temporary address, or your domain.
  2. The home page should appear. If you see your host’s welcome page instead, see step 9. Then add /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.
  3. Safety check: add /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.
  4. If you created your login on your computer (step 3), log in. You are done with this step. If Kirby refuses your correct password, .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.

How to edit site/config/config.php

You need this for the installer switch below, the url line in step 7 and the debug line in step 9.

  1. Take the file from your template folder on your computer, or download it from site/config/ on the server.
  2. Open it in a plain-text editor, not a word processor. On a Mac, TextEdit works: choose Format → Make Plain Text if that item is there, and turn off Edit → Substitutions → Smart Quotes. Curly quotes break the file. On Windows, Notepad works.
  3. Make the change. Type the quote marks, commas and brackets exactly as shown.
  4. Save. Upload the file into site/config/ on the server, and let it replace the old one.
The other way: switch the installer on for a few minutes

Do this only if you cannot use your computer, and preferably after HTTPS works (step 7). Over plain http://, your new password travels unencrypted.

  1. In 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,
        …
  2. Upload the file and open /panel at once. While the line is there, whoever opens /panel first becomes the administrator.
  3. Create your account.
  4. Delete the two lines, save, and upload the file again. Kirby recommends removing the setting after the install.

Source: Kirby — panel options.

07 Connect your domain and turn on HTTPS

The domain

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.

  1. Change the nameservers (the servers that answer for your domain). At the company where you bought the domain, replace all its nameservers with the ones your host gives you. Cafe24 calls this the most common and recommended way (Cafe24 help). Then add the domain in your host’s control panel (Cafe24: 나의 서비스 관리 > 호스팅관리 > 기본관리 > 도메인 연결관리).
  2. Or edit the DNS records at the company where you bought the domain. Add or change two lines:
    • 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).
    Your host’s help page lists the exact values. Copy them as they are. Then add the domain in the host’s control panel as well.

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

  1. Turn on the certificate in your host’s control panel. Many hosts issue and renew it for you, on their own or once you turn on a setting (Let’s Encrypt). Shared hosting rarely lets you do it any other way, so ask the host if you can’t find the setting. Let’s Encrypt certificates are free, but hosts may charge a small fee for setting them up (Let’s Encrypt FAQ).
  2. Open https:// plus your domain. Look for the padlock.
  3. If your host has a setting that always sends visitors to https://, turn it on.
  4. If links on your site still start with 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)

08 Buy and enter the Kirby licence

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.

Basic
For a yearly revenue or funding under €1 million. For client work, the client’s revenue counts, at the time of purchase.
Enterprise
For everyone else.
Price
A one-time fee per site, + VAT if applicable, with 3 years of free updates. Current prices: getkirby.com/buy.
One licence
One installation on one domain. Each extra subdomain or subfolder installation needs its own licence.
Withdrawal
Consumers may withdraw within 14 days of purchase.

As of October 2026: getkirby.com/buy, getkirby.com/license. These are Kirby’s terms, not ours. Kirby sells the licence, not STstudio.

  1. Buy the licence at getkirby.com/buy. Kirby sends you a licence code for your domain.
  2. On the live site, at your real domain, log in to the Panel. Click Activate at the bottom left, enter your code and follow Kirby’s screen. The licence is activated for the domain the Panel is open on (Kirby quickstart).
You have a licence file instead of a code?

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.

09 When something goes wrong

Find what you see, then read why and what to do.

What you seeWhyWhat to do
Your host’s welcome page, not your siteThe 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 pageA 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 passwordThe 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 garbledThe mbstring extension is missing.Ask the host to turn on mbstring.
The Panel cannot save your changesKirby may not write to content/.Make content/ and its folders writable (step 5).
Images or thumbnails do not appearMost 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 addressKirby guesses the address from the server, and sometimes guesses wrong.Set the url option to your https:// address (step 7).
Dates or times are offThe server’s time zone setting (date.timezone).Ask the host to set it.
The domain does not open yetDNS is still updating.Wait up to 48 hours. Check the nameservers or records (step 7).
No padlock, or the browser warns about the connectionThe 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 brokenAn 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.

10 Keep it safe

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.

Backups

Download these from the server to your computer regularly, and always before a change:

Do not rely on the host’s backups alone. On Cafe24, for example, changing the PHP version deletes them.

Debug mode stays off

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

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.

Updating Kirby (within version 5)
  1. Back up first.
  2. Try the update on your computer, not on the live site. Kirby says never to update a live website directly on the server.
  3. Download the newest Plainkit tag that starts with 5. (step 2). Replace your kirby folder with its kirby folder.
  4. Delete the media folder. Kirby makes it again.
  5. Check the site and the Panel on your computer.
  6. On the server, rename the old 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.