Installazione
Peculium è una classica app self-hosted, e installarla avviene solo via pull: sulla tua macchina non si compila nulla. Le immagini ufficiali sono pubbliche su GitHub Container Registry — download anonimi, senza login e senza token — perlinux/amd64 elinux/arm64.
Prerequisiti
- Podman (o Docker) con il supporto a Compose, su un qualsiasi server Linux, NAS o VM.
- Una macchina amd64 oarm64: le immagini sono multi-arch.
Le immagini sono pubblicate su ghcr.io/alv67/peculium-*(frontend, backend, worker, python-service, secrets-init) a partire dalla releasev1.0.0.
Passo 1 — Scarica i file della stack
Recupera il compose di release e il template degli ambienti di variabili:
curl -O https://raw.githubusercontent.com/alv67/peculium/main/docker-compose.yml
curl -O https://raw.githubusercontent.com/alv67/peculium/main/.env.example
cp .env.example .env # opzionalePasso 2 — Configura (facoltativo)
Ogni valore ha un sensato default: puoi anche saltare .enve la stack parte con segreti generati automaticamente. Modificalo solo se vuoi cambiare qualcosa:
| Variabile | Default | Note |
|---|---|---|
| PECULIUM_VERSION | latest | Tag delle immagini di tutti i servizi Peculium — fissa una release (es. v1.0.0) per bloccare la stack su una versione. |
| PECULIUM_HTTP_PORT | 3000 | Porta dell’host su cui è pubblicata l’interfaccia web. |
| POSTGRES_PASSWORD | (vuota) | Lasciala vuota per generarne una casuale al primo avvio. |
| PECULIUM_JWT_SECRET | (vuota) | Lasciala vuota per generarne uno casuale al primo avvio. Modificarlo disconnette tutti. |
Passo 3 — Avvia
podman-compose up -dInterfaccia web, API, worker, servizio prezzi, PostgreSQL e Redis partono insieme; il primoupgenera e salva anche i segreti (vedi le note qui sotto).
Passo 4 — Apri Peculium
Punta il browser a http://localhost:3000e crea il primo account. Da lì aggiungi asset e portfolio: a recuperare i prezzi ci pensa Peculium.
Buono a sapersi
- Fai il backup del volume dei segreti.Al primo avvio la password del database e il segreto JWT vengono generati automaticamente e persistiti nel volume
peculium_secrets, per essere riutilizzati a ogni riavvio — se perdi quel volume perdi l’accesso al database. - PostgreSQL e Redis nonsono esposti sull’host; dell’intera stack è pubblicata solo la porta della web UI (il backend è raggiungibile tramite il proxy
/api/del frontend). - Per aggiornare scarica il nuovo tag e riavvia in-place:
PECULIUM_VERSION=vX.Y.Z podman-compose pull && podman-compose up -d
Qualcosa non funziona? Apri una issue su GitHub.