Deploy Koel on Pethost in one click

What happens

1. You sign in to Pethost or make an account, with a passkey, GitHub or Google.
2. No machine yet? You pick a plan, and we prepare one for you. The link waits in your browser until it is ready.
3. New project opens at the app. You fill in what it asks for and click Create project: Email, Admin password.
4. In a minute or two the app is live at its own address with HTTPS. Its secrets are made for it at random, and its data is in the nightly backup.
5. It is a project like any other: its compose.yaml, its .env, its logs and a terminal are in the panel, and your agent can change it, roll it back or restore it.

First steps

Sign in with the email and the admin password you gave. Upload songs in Koel, or copy them into the project’s music volume and scan the library in Settings.

What it runs

The template is this compose.yaml and the variables it writes into the project’s .env. Pethost runs the file as it is written.

services:
  koel:
    image: phanan/koel:9.15.0
    restart: unless-stopped
    environment:
      APP_URL: ${URL}
      FORCE_HTTPS: "true"
      APP_DEBUG: "false"
      APP_KEY: ${APP_KEY}
      DB_CONNECTION: pgsql
      DB_HOST: database
      DB_PORT: 5432
      DB_DATABASE: koel
      DB_USERNAME: koel
      DB_PASSWORD: ${DB_PASSWORD}
      ADMIN_EMAIL: ${ADMIN_EMAIL}
      ADMIN_PASSWORD: ${ADMIN_PASSWORD}
    # The image initialises Koel only when a .env file exists, and koel:init makes the admin
    # with a password everyone knows: the admin gets the email and the password given instead,
    # while it still has that one.
    entrypoint:
      - sh
      - -c
      - |
        cd /var/www/html
        touch .env && chown www-data .env
        runuser -u www-data -- koel-init
        runuser -u www-data -- php -r '
          require "vendor/autoload.php";
          $$app = require "bootstrap/app.php";
          $$app->make(Illuminate\Contracts\Console\Kernel::class)->bootstrap();
          $$admin = App\Models\User::where("email", App\Models\User::FIRST_ADMIN_EMAIL)->first();
          if ($$admin && Illuminate\Support\Facades\Hash::check(App\Models\User::FIRST_ADMIN_PASSWORD, $$admin->password)) {
            $$admin->email = getenv("ADMIN_EMAIL");
            $$admin->password = Illuminate\Support\Facades\Hash::make(getenv("ADMIN_PASSWORD"));
            $$admin->save();
          }'
        exec docker-php-entrypoint apache2-foreground
    depends_on:
      database:
        condition: service_healthy
    # The three folders the image declares as volumes.
    volumes:
      - music:/music
      - images:/var/www/html/storage/app/public/images
      - search:/var/www/html/storage/search-indexes

  database:
    image: postgres:18.3-alpine
    restart: unless-stopped
    environment:
      POSTGRES_DB: koel
      POSTGRES_USER: koel
      POSTGRES_PASSWORD: ${DB_PASSWORD}
    volumes:
      - db:/var/lib/postgresql
    healthcheck:
      test: ["CMD", "pg_isready", "-U", "koel", "-d", "koel"]
      interval: 5s
      timeout: 5s
      retries: 20

volumes:
  music:
  images:
  search:
  db:

compose.yamlSee it on GitHub