This is a ready-to-use Docker configuration that spawns a local development server with Apache and ImageMagick.

Multiple Kirby projects can live in the folders adjacent to this repo and will automatically be reachable as virtual hosts like this: http://foldername.localhost

You’ll need to get Docker Desktop first.

This Docker configuration assumes the following folder structure:

(parent folder, e.g. /Users/YourUserName/Web)
├── docker-kirby-server
│  └── (contents of this repo) ←←←
├── mykirbyproject
├── mykirbyotherproject
└── …

Open Docker Desktop, go to Settings → Resources → File Sharing and grant access to this repository’s parent folder, e.g. /Users/YourUserName/Web.

You can now access your Kirby projects in the browser by appending .localhost to the folder name, e.g. http://mykirbyproject.localhost and http://mykirbyotherproject.localhost

As a fallback, the standard http://localhost address shows the content of the _localhost folder in this repository.

The local virtual hosts should work with Firefox out of the box. For other browsers, you may have to append each virtual host to your /etc/hosts file like this:

127.0.0.1	mykirbyproject.localhost
127.0.0.1	myotherkirbyproject.localhost
…

Point your terminal to this repository and run docker-compose up.

If you’re running a virtual web server on your computer, you should know what you’re doing and what the security implications are. Also, please note that the server will be reachable on the local network by default.

MIT