Instalacja

Uruchom swoje portfolio fotograficzne Galleria w kilka minut za pomocą Dockera lub trybu dewelopera.

Wymagania wstępne

Zanim zaczniesz, upewnij się, że masz jeden z następujących:

  • Do wdrożenia z użyciem Dockera (zalecane): Docker i Docker Compose
  • Do rozwoju: Node.js 18+ i npm
  • Opcjonalnie: dane uwierzytelniające Google OAuth (uwierzytelnianie hasłem działa bez tego)

Szybki start z Docker Hub

Najszybszym sposobem na rozpoczęcie jest użycie naszych wstępnie zbudowanych obrazów Dockera.

1. Pobierz obraz Dockera

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

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

2. Utwórz katalog danych

Utwórz katalog do przechowywania swoich zdjęć i bazy danych:

mkdir -p ~/galleria-data

3. Uruchom kontener

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. Uzyskaj dostęp do swojej witryny

Otwórz przeglądarkę i przejdź do:

Frontend:http://localhost:3000
Panel administracyjny:http://localhost:3000/admin

Kreator konfiguracji poprowadzi cię przez początkową konfigurację przy pierwszej wizycie.

Ustawienia dewelopera

Aby rozwijać lub przyczynić się do Galleria:

1. Sklonuj repozytorium

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

2. Zainstaluj zależności

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

3. Uruchom serwer deweloperski

npm run dev

To uruchamia zarówno frontend, jak i backend w trybie deweloperskim z hot reload.

Ustawienie Docker Compose

Aby zbudować i uruchomić z źródła za pomocą Docker Compose:

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

Edytuj docker-compose.yml, aby dostosować porty i zmienne środowiskowe.

Konfiguracja

Konfiguracja jest zarządzana za pomocą zmiennych środowiskowych lub panelu administracyjnego.

Zmienne środowiskowe

ZmiennaOpisPrzykład
DATA_DIRKatalog dla zdjęć i bazy danych/data
FRONTEND_DOMAINPubliczny adres URL twojej stronyhttps://yourdomain.com
BACKEND_DOMAINAdres URL punktu końcowego APIhttps://api.yourdomain.com

Konfiguracja panelu administracyjnego: Po początkowej konfiguracji, wszystkie ustawienia można zarządzać przez panel administracyjny pod /admin → Ustawienia

Kolejne kroki

Teraz, gdy masz zainstalowane Galleria: