Vai al contenuto
Peculium

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

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   # opzionale

Passo 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:

VariabileDefaultNote
PECULIUM_VERSIONlatestTag delle immagini di tutti i servizi Peculium — fissa una release (es. v1.0.0) per bloccare la stack su una versione.
PECULIUM_HTTP_PORT3000Porta 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 -d

Interfaccia 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

Qualcosa non funziona? Apri una issue su GitHub.