Pemasangan

Dapatkan portfolio fotografi Galleria anda berfungsi dalam beberapa minit dengan Docker atau mod pembangunan.

Keperluan

Sebelum anda mula, pastikan anda mempunyai salah satu daripada yang berikut:

  • Untuk penyebaran Docker (Disyorkan): Docker & Docker Compose
  • Untuk pembangunan: Node.js 18+ dan npm
  • Pilihan: Kelayakan Google OAuth (pengesahan kata laluan berfungsi tanpa itu)

Permulaan Pantas dengan Docker Hub

Cara terpantas untuk bermula adalah dengan menggunakan imej Docker pra-bina kami.

1. Tarik Imej Docker

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

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

2. Buat Direktori Data

Buat direktori untuk menyimpan foto dan pangkalan data anda:

mkdir -p ~/galleria-data

3. Jalankan Kontena

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. Akses Laman Anda

Buka penyemak imbas anda dan navigasi ke:

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

Wizard pemasangan akan membimbing anda melalui konfigurasi awal pada lawatan pertama.

Pemasangan Pembangunan

Untuk pembangunan atau menyumbang kepada Galleria:

1. Klon Repositori

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

2. Pasang Kebergantungan

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

3. Mula Pelayan Pembangunan

npm run dev

Ini memulakan kedua-dua frontend dan backend dalam mod pembangunan dengan muat semula panas.

Persediaan Docker Compose

Untuk membina dan menjalankan dari sumber dengan Docker Compose:

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

Edit docker-compose.yml untuk menyesuaikan port dan pembolehubah persekitaran.

Konfigurasi

Konfigurasi diurus melalui pembolehubah persekitaran atau panel admin.

Pembolehubah Persekitaran

PembolehubahPeneranganContoh
DATA_DIRDirektori untuk foto dan pangkalan data/data
FRONTEND_DOMAINURL Awam laman andahttps://yourdomain.com
BACKEND_DOMAINURL titik akhir APIhttps://api.yourdomain.com

Konfigurasi Panel Admin: Selepas persediaan awal, semua tetapan boleh diurus melalui panel admin di /admin → Tetapan

Langkah Seterusnya

Sekarang anda telah memasang Galleria: