Instal·lació

Fes que el teu portafoli de fotografia Galleria estigui en funcionament en minuts amb Docker o en mode de desenvolupament.

Requisits previs

Abans de començar, assegura't que tens un dels següents:

  • Per a la implementació amb Docker (Recomanat): Docker i Docker Compose
  • Per al desenvolupament: Node.js 18+ i npm
  • Opcional: credencials d'OAuth de Google (l'autenticació per contrasenya funciona sense això)

Inici ràpid amb Docker Hub

La manera més ràpida de començar és utilitzant les nostres imatges de Docker preconstruïdes.

1. Descarrega la imatge de Docker

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

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

2. Crea el directori de dades

Crea un directori per emmagatzemar les teves fotos i la base de dades:

mkdir -p ~/galleria-data

3. Executa el contenidor

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. Accedeix al teu lloc

Obre el teu navegador i navega a:

Frontend:http://localhost:3000
Panell d'administració:http://localhost:3000/admin

L'assistent de configuració et guiarà a través de la configuració inicial en la primera visita.

Configuració de desenvolupament

Per al desenvolupament o contribuir a Galleria:

1. Clona el repositori

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

2. Instal·la les dependències

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

3. Inicia el servidor de desenvolupament

npm run dev

Això inicia tant el frontend com el backend en mode de desenvolupament amb recàrrega automàtica.

Configuració de Docker Compose

Per construir i executar des del codi font amb Docker Compose:

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

Edita docker-compose.yml per personalitzar ports i variables d'entorn.

Configuració

La configuració es gestiona a través de variables d'entorn o del panell d'administració.

Variables d'Entorn

VariableDescripcióExemple
DATA_DIRDirectori per a fotos i base de dades/data
FRONTEND_DOMAINURL pública del teu llochttps://yourdomain.com
BACKEND_DOMAINURL de l'endpoint de l'APIhttps://api.yourdomain.com

Configuració del panell d'administració: Després de la configuració inicial, totes les configuracions es poden gestionar a través del panell d'administració a /admin → Configuracions

Properes passes

Ara que tens Galleria instal·lat: