---
title: "Faça o deploy de Koel no Pethost com um clique"
description: "Sua biblioteca de música em streaming no navegador e nos apps do celular, um Spotify pessoal. Um template para o Pethost: em um ou dois minutos o app está no ar na sua máquina, com HTTPS no próprio endereço e backups noturnos."
---

[← Todos os templates](https://pethost.dev/pt/templates/)

# Faça o deploy de Koel no Pethost com um clique

Sua biblioteca de música em streaming no navegador e nos apps do celular, um Spotify pessoal

[Fazer deploy no Pethost](https://console.pethost.dev/?template=koel)

## O que acontece

1. Você entra no Pethost ou cria uma conta, com uma passkey, GitHub ou Google.
2. Ainda não tem máquina? Você escolhe um plano, e nós preparamos uma para você. O link espera no seu navegador até ela ficar pronta.
3. Novo projeto abre no app. Você preenche o que ele pede e clica em Criar projeto: **E-mail**, **Senha do administrador**.
4. Em um ou dois minutos o app está no ar no próprio endereço com HTTPS. Os segredos dele são gerados ao acaso, e os dados vão para o backup noturno.
5. É um projeto como qualquer outro: o compose.yaml, o .env, os logs e um terminal ficam no painel, e seu agente pode alterá-lo, fazer rollback ou restaurá-lo.

## Primeiros passos

Entre com o e-mail e a senha de administrador que você informou. Envie músicas pelo Koel, ou copie-as para o volume music do projeto e escaneie a biblioteca em Settings.

## O que roda

O template é este compose.yaml e as variáveis que ele grava no .env do projeto. O Pethost roda o arquivo exatamente como está escrito.

```
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.yaml](https://pethost.dev/templates/koel/compose.yaml)[Ver no GitHub](https://github.com/pethost-dev/templates/tree/main/koel)

Pethost · Stephan Gomer · NIP 1133096755

[Templates](https://pethost.dev/pt/templates/) [Sobre nós](https://pethost.dev/about/) [Blog](https://pethost.dev/blog/) [Termos](https://pethost.dev/terms/) [Privacidade](https://pethost.dev/privacy/) [Reembolsos](https://pethost.dev/refunds/) [API](https://pethost.dev/docs/api/) [CLI](https://pethost.dev/docs/cli/) [Plugin](https://github.com/pethost-dev/plugin) [support@pethost.dev](mailto:support@pethost.dev)