Installazione

Fai partire il tuo portfolio fotografico Galleria in pochi minuti con Docker o in modalità sviluppo.

Requisiti

Prima di iniziare, assicurati di avere uno dei seguenti:

  • Per il deployment con Docker (Consigliato): Docker & Docker Compose
  • Per lo sviluppo: Node.js 18+ e npm
  • Opzionale: credenziali Google OAuth (l'autenticazione con password funziona senza di esse)

Guida Rapida con Docker Hub

Il modo più veloce per iniziare è utilizzare le nostre immagini Docker pre-costruite.

1. Scarica l'immagine Docker

# Pull latest production image
docker pull tedcharles/galleria:latest

Docker Hub: hub.docker.com/r/tedcharles/galleria

2. Crea la directory dei dati

Crea una directory per memorizzare le tue foto e il tuo database:

mkdir -p ~/galleria-data

3. Esegui il contenitore

docker run -d \
  --name galleria \
  -p 3000:3000 \
  -p 3001:3001 \
  -v ~/galleria-data:/data \
  -e DATA_DIR=/data \
  -e FRONTEND_DOMAIN=http://localhost:3000 \
  -e BACKEND_DOMAIN=http://localhost:3001 \
  tedcharles/galleria:latest

4. Accedi al tuo sito

Apri il tuo browser e vai a:

Frontend:http://localhost:3000
Pannello di Amministrazione:http://localhost:3000/admin

Il wizard di configurazione ti guiderà attraverso la configurazione iniziale al primo accesso.

Impostazione dello Sviluppo

Per lo sviluppo o il contributo a Galleria:

1. Clona il Repository

git clone https://github.com/theodorecharles/Galleria.git
cd Galleria

2. Installa le Dipendenze

npm install
cd backend && npm install
cd ../frontend && npm install
cd ..

3. Avvia il Server di Sviluppo

npm run dev

Questo avvia sia il frontend che il backend in modalità sviluppo con hot reload.

Impostazione di Docker Compose

Per costruire ed eseguire dal sorgente con Docker Compose:

git clone https://github.com/theodorecharles/Galleria.git
cd Galleria
mkdir -p ~/galleria-data
docker-compose up -d --build

Modifica docker-compose.yml per personalizzare le porte e le variabili di ambiente.

Configurazione

La configurazione è gestita tramite variabili di ambiente o il pannello di amministrazione.

Variabili di Ambiente

VariabileDescrizioneEsempio
DATA_DIRDirectory per foto e database/data
FRONTEND_DOMAINURL pubblico del tuo sitohttps://yourdomain.com
BACKEND_DOMAINURL dell'endpoint APIhttps://api.yourdomain.com

Configurazione del Pannello di Amministrazione: Dopo la configurazione iniziale, tutte le impostazioni possono essere gestite tramite il pannello di amministrazione su /admin → Impostazioni

Prossimi Passi

Ora che hai installato Galleria: