Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/frankrausch/docker-kirby-server


https://github.com/frankrausch/docker-kirby-server

Last synced: about 6 hours ago
JSON representation

Awesome Lists containing this project

README

        

# Docker Desktop Local Server Config for Kirby CMS

## What’s this?

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`

## How to install

You’ll need to get [Docker Desktop](https://www.docker.com/products/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

```

## How to run

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

## Use at your own risk

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.

## License

MIT