Telepítés

A Galleria fényképportfóliódat percek alatt üzembe helyezheted Docker vagy fejlesztési mód használatával.

Előfeltételek

Mielőtt elkezdenéd, győződj meg róla, hogy rendelkezel az alábbiak egyikével:

  • Docker telepítéshez (ajánlott): Docker & Docker Compose
  • Fejlesztéshez: Node.js 18+ és npm
  • Opcionális: Google OAuth hitelesítő adatok (jelszóval történő hitelesítés működik nélküle)

Gyors kezdés a Docker Hub-bal

A leggyorsabb módja a kezdésnek, ha a kész Docker képeinket használod.

1. Húzd le a Docker képet

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

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

2. Hozz létre adatkönyvtárat

Hozz létre egy könyvtárat a fényképeid és az adatbázisod tárolására:

mkdir -p ~/galleria-data

3. Futtasd a konténert

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. Érd el a webhelyedet

Nyisd meg a böngésződet és navigálj ide:

Frontend:http://localhost:3000
Admin panel:http://localhost:3000/admin

A beállító varázsló végigvezet az első látogatáskor a kezdeti konfiguráción.

Fejlesztési beállítás

A Galleria fejlesztéséhez vagy hozzájárulásához:

1. Klónozd a tárolót

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

2. Telepítsd a függőségeket

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

3. Indítsd el a fejlesztői szervert

npm run dev

Ez elindítja a frontendet és a backendet fejlesztési módban, automatikus újratöltéssel.

Docker Compose beállítás

Forrásból való építéshez és futtatáshoz Docker Compose-szal:

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

Szerkeszd a docker-compose.yml fájlt a portok és környezeti változók testreszabásához.

Konfiguráció

A konfigurációt környezeti változókon vagy az admin panelen keresztül kezelik.

Környezeti változók

VáltozóLeírásPélda
DATA_DIRKönyvtár a fényképek és az adatbázis számára/data
FRONTEND_DOMAINA webhelyed nyilvános URL-jehttps://yourdomain.com
BACKEND_DOMAINAPI végpont URL-jehttps://api.yourdomain.com

Admin Panel Konfiguráció: Az első beállítás után minden beállítást az admin panelen keresztül lehet kezelni a /admin → Beállítások menüpont alatt

Következő lépések

Most, hogy telepítetted a Galleria-t: