Fountain

Quick start guide

This guide will get you up and running with Fountain in no time. You'll set up a Kirby site with Fountain, upload your first font, and see it in action.

What you'll need

Prerequisites

  • Basic command‑line proficiency.
  • Option A: Set up Docker using either
  • Option B: Install the following manually:
    • PHP 8.3 or newer
    • Python 3.8 or newer
    • A local web server (e.g., Apache, Nginx, or the built‑in PHP server).

1. Setup Docker

I recommend using OrbStack.

2. Setup Fountain

Create a folder for your project and move the files from your Fountain download.

3. Get latest Kirby.

Go and get the lastest version or Kirby. You only need the kirby folder, and put it in the root pf your project.

4. Changes in docker-compose.yml

Only change the path to your project in docker-compose.yml under volumes:. This volume is synced with the Docker container, so any modifications you make will be reflected in the Docker image. Do not alter anything after the colon.

services:
  kirby_fountain:
    platform: "linux/arm64"
    build: .
    volumes:
      - /path/to/your/project:/var/www/
    ports:
      - "443:443"
      - "80:80"
    environment:
      UPLOAD_LIMIT: 64M

  mailhog:
    container_name: mailhog
    image: mailhog/mailhog:latest
    restart: always
    hostname: mailhog
    ports:
      - "1025:1025"
      - "8025:8025"

5. Start Docker container

Fountain comes with everything to get going with Docker, so using your preferred terminal, cd /path/to/project and then 

docker-compose up --build

5. Access your site

  • OrbStack: Your site will be available at a …orb.local domain. In OrbStack, go to Containers, expand your project, right‑click the image named website, and copy the domain.
  • Docker Desktop: Visit http://localhost:8000

6. Log in to the Panel

Navigate to the panel (add /panel to your URL) and log in with the default credentials provided in the starter kit.

Option B: Manual Setup

This option requires that PHP and Python are already installed.

1. Set up Kirby

2. Install Fountain plugin

3. Install Python dependencies

4. Start your local server

5. Access your site

6. Log in to the Panel

Jump do: