Instalación

Ponga en marcha su portafolio de fotografía Galleria en minutos con Docker o en modo de desarrollo.

Requisitos previos

Antes de comenzar, asegúrese de tener uno de los siguientes:

Para implementación con Docker (Recomendado): Docker y Docker Compose
Para desarrollo: Node.js 18+ y npm
Opcional: credenciales de Google OAuth (la autenticación por contraseña funciona sin ello)

Inicio rápido con Docker Hub

La forma más rápida de comenzar es utilizando nuestras imágenes de Docker preconstruidas.

1. Descargar la imagen de Docker

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

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

2. Crear directorio de datos

Cree un directorio para almacenar sus fotos y base de datos:

mkdir -p ~/galleria-data

3. Ejecutar el contenedor

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. Acceder a su sitio

Abra su navegador y navegue a:

Frontend:http://localhost:3000

Panel de administración:http://localhost:3000/admin

El asistente de configuración lo guiará a través de la configuración inicial en la primera visita.

Configuración de desarrollo

Para el desarrollo o contribución a Galleria:

1. Clona el Repositorio

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

2. Instala Dependencias

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

3. Inicia el Servidor de Desarrollo

npm run dev

Esto inicia tanto el frontend como el backend en modo de desarrollo con recarga en caliente.

Configuración de Docker Compose

Para construir y ejecutar desde el código fuente con 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 para personalizar puertos y variables de entorno.

Configuración

La configuración se gestiona a través de variables de entorno o el panel de administración.

Variables de Entorno

Variable	Descripción	Ejemplo
DATA_DIR	Directorio para fotos y base de datos	/data
FRONTEND_DOMAIN	URL pública de tu sitio	https://yourdomain.com
BACKEND_DOMAIN	URL del endpoint de la API	https://api.yourdomain.com

Configuración del Panel de Administración: Después de la configuración inicial, todos los ajustes se pueden gestionar a través del panel de administración en /admin → Configuración

Próximos Pasos

Ahora que tienes Galleria instalado:

1. Navega a /admin para acceder al panel de administración
2. Crea álbumes y sube tus fotos
3. Personaliza tu sitio en Configuración (marca, SEO, idioma, etc.)
Lee la documentación completa
Ver el código fuente en GitHub