Auto-hosting
Self-hosting di Pluma con Docker
Esegui Pluma sulla tua infrastruttura. Un container, un file compose, cinque minuti dal server vuoto all'app in funzione.
Linux · 2 vCPU · 4 GBDocker + Compose v2Licenza (solo piani a pagamento)
Avvio rapido
Avvio rapido (5 minuti)
1
Scegli una directory
Scegli una directory
sudo mkdir -p /opt/pluma && sudo chown $USER:$USER /opt/pluma
cd /opt/pluma2
Crea il file compose
Crea il file compose
Salva come docker-compose.yml.
services:
pluma:
image: mertdalbudak/pluma:latest
container_name: pluma
restart: unless-stopped
env_file: .env
ports:
- "4100:4100"
volumes:
- builder-data:/app/builder/data
# Lets the Pro+ Publish flow drive `docker buildx`. Remove this line
# if you won't publish workspace renderer images.
- /var/run/docker.sock:/var/run/docker.sock
healthcheck:
test: ["CMD", "wget", "-qO-", "http://localhost:4100/health"]
interval: 30s
timeout: 5s
retries: 5
volumes:
builder-data:
3
Crea il file env
Crea il file env
Salva come .env. Contano solo quattro valori — il resto viene generato automaticamente al primo avvio.
# Where Pluma is reachable. http://localhost:4100 for internal,
# https://pluma.your-company.com when fronted by TLS.
PUBLIC_URL=http://localhost:4100
# Free tier needs no key. For paid tiers, paste your license here.
LICENSE_KEY=
# ── Database ─────────────────────────────────────────────────────────
# Recommended: point at your own PostgreSQL — easier to back up, scale,
# and operate alongside your other infra. Uncomment and fill in:
# DATABASE_URL=postgresql://USER:PASS@host:5432/pluma
#
# Leave it unset and the container uses a bundled SQLite file under the
# builder-data volume — zero database to run, fine for a single team.
# ── Object storage (optional) ────────────────────────────────────────
# By default uploaded PDFs and images live in the builder-data volume.
# To put them in S3-compatible object storage instead (MinIO, Hetzner
# Object Storage, AWS S3, Cloudflare R2, Backblaze B2, …), set
# STORAGE_BACKEND=s3 and fill in the rest. Useful when you want to
# horizontally scale the builder, share storage across nodes, or
# offload the data volume from the application host.
#
# Database backups are configured from the in-app GUI, not from this
# file — leave the storage block here for application data only.
# STORAGE_BACKEND=s3
# S3_BUCKET=pluma
# S3_ENDPOINT=https://your-s3-endpoint
# S3_PUBLIC_ENDPOINT=https://your-s3-endpoint
# S3_REGION=eu-central-1
# S3_ACCESS_KEY=...
# S3_SECRET_KEY=...
PUBLIC_URLDove vive l’installazioneLICENSE_KEYSolo piani a pagamento — lascia vuoto per Free4
Avvia lo stack
Avvia lo stack
docker compose up -d
docker compose logs -f pluma5
Verifica
Verifica
Se entrambi gli endpoint rispondono, è attivo.
curl http://127.0.0.1:4100/health
# → {"ok":true,"service":"builder"}Apri http://your-host:4100 e registrati con l’e-mail impostata in
Aggiornamento
Aggiornamento
docker compose pull
docker compose up -dLe migrazioni del database vengono eseguite automaticamente all'avvio del builder, prima che il server HTTP accetti traffico. Nessun passaggio manuale.
Serve una licenza?
Il piano Free funziona senza licenza. I piani Advanced e Pro richiedono una chiave di licenza — acquistane una sul nostro sito hosted, incollala nel tuo .env come LICENSE_KEY e ridistribuisci.