Instalação

Coloque seu portfólio de fotografia Galleria em funcionamento em minutos com Docker ou modo de desenvolvimento.

Pré-requisitos

Antes de começar, certifique-se de ter um dos seguintes:

  • Para implantação com Docker (Recomendado): Docker & Docker Compose
  • Para desenvolvimento: Node.js 18+ e npm
  • Opcional: credenciais do Google OAuth (a autenticação por senha funciona sem isso)

Início Rápido com Docker Hub

A maneira mais rápida de começar é usando nossas imagens Docker pré-construídas.

1. Puxe a Imagem Docker

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

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

2. Crie o Diretório de Dados

Crie um diretório para armazenar suas fotos e banco de dados:

mkdir -p ~/galleria-data

3. Execute o Contêiner

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. Acesse Seu Site

Abra seu navegador e navegue até:

Frontend:http://localhost:3000
Painel de Administração:http://localhost:3000/admin

O assistente de configuração irá guiá-lo pela configuração inicial na primeira visita.

Configuração de Desenvolvimento

Para desenvolvimento ou contribuição para Galleria:

1. Clone o Repositório

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

2. Instale as Dependências

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

3. Inicie o Servidor de Desenvolvimento

npm run dev

Isso inicia tanto o frontend quanto o backend em modo de desenvolvimento com recarregamento automático.

Configuração do Docker Compose

Para construir e executar a partir do código-fonte com Docker Compose:

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

Edite docker-compose.yml para personalizar portas e variáveis de ambiente.

Configuração

A configuração é gerenciada através de variáveis de ambiente ou do painel de administração.

Variáveis de Ambiente

VariávelDescriçãoExemplo
DATA_DIRDiretório para fotos e banco de dados/data
FRONTEND_DOMAINURL pública do seu sitehttps://yourdomain.com
BACKEND_DOMAINURL do endpoint da APIhttps://api.yourdomain.com

Configuração do Painel de Administração: Após a configuração inicial, todas as configurações podem ser gerenciadas através do painel de administração em /admin → Configurações

Próximos Passos

Agora que você tem o Galleria instalado: