Instalasi

Dapatkan portofolio fotografi Galleria Anda berjalan dalam hitungan menit dengan Docker atau mode pengembangan.

Prasyarat

Sebelum Anda mulai, pastikan Anda memiliki salah satu dari berikut ini:

  • Untuk penyebaran Docker (Direkomendasikan): Docker & Docker Compose
  • Untuk pengembangan: Node.js 18+ dan npm
  • Opsional: Kredensial Google OAuth (autentikasi kata sandi berfungsi tanpa itu)

Panduan Cepat dengan Docker Hub

Cara tercepat untuk memulai adalah dengan menggunakan gambar Docker yang telah kami buat sebelumnya.

1. Tarik Gambar 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 database Anda:

mkdir -p ~/galleria-data

3. Jalankan Kontainer

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 Situs Anda

Buka browser Anda dan navigasikan ke:

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

Wizard pengaturan akan memandu Anda melalui konfigurasi awal pada kunjungan pertama.

Pengaturan Pengembangan

Untuk pengembangan atau berkontribusi pada Galleria:

1. Kloning Repositori

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

2. Instal Ketergantungan

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

3. Mulai Server Pengembangan

npm run dev

Ini memulai frontend dan backend dalam mode pengembangan dengan hot reload.

Pengaturan Docker Compose

Untuk membangun 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 variabel lingkungan.

Konfigurasi

Konfigurasi dikelola melalui variabel lingkungan atau panel admin.

Variabel Lingkungan

VariabelDeskripsiContoh
DATA_DIRDirektori untuk foto dan basis data/data
FRONTEND_DOMAINURL Publik situs Andahttps://yourdomain.com
BACKEND_DOMAINURL endpoint APIhttps://api.yourdomain.com

Konfigurasi Panel Admin: Setelah pengaturan awal, semua pengaturan dapat dikelola melalui panel admin di /admin → Pengaturan

Langkah Selanjutnya

Sekarang Anda telah menginstal Galleria: