Pag-install

I-set up ang iyong Galleria photography portfolio sa loob ng ilang minuto gamit ang Docker o development mode.

Mga Kinakailangan

Bago ka magsimula, siguraduhing mayroon ka ng isa sa mga sumusunod:

Para sa Docker deployment (Inirerekomenda): Docker at Docker Compose
Para sa development: Node.js 18+ at npm
Opsyonal: Google OAuth credentials (gumagana ang password auth nang walang ito)

Mabilis na Pagsisimula gamit ang Docker Hub

Ang pinakamabilis na paraan upang makapagsimula ay gamit ang aming pre-built Docker images.

1. Kunin ang Docker Image

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

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

2. Lumikha ng Data Directory

Lumikha ng isang direktoryo upang itago ang iyong mga larawan at database:

mkdir -p ~/galleria-data

3. Patakbuhin ang Container

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. I-access ang Iyong Site

Buksan ang iyong browser at mag-navigate sa:

Frontend:http://localhost:3000

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

Gagabayan ka ng setup wizard sa paunang configuration sa unang pagbisita.

Development Setup

Para sa pag-unlad o kontribusyon sa Galleria:

1. I-clone ang Repository

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

2. I-install ang mga Dependencies

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

3. Simulan ang Development Server

npm run dev

Nagsisimula ito ng parehong frontend at backend sa development mode na may hot reload.

Docker Compose Setup

Para sa pagbuo at pagpapatakbo mula sa source gamit ang Docker Compose:

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

I-edit ang docker-compose.yml upang i-customize ang mga port at mga environment variable.

Configuration

Ang configuration ay pinamamahalaan sa pamamagitan ng mga environment variable o ng admin panel.

Mga Environment Variable

Variable	Paglalarawan	Halimbawa
DATA_DIR	Directory para sa mga larawan at database	/data
FRONTEND_DOMAIN	Pampublikong URL ng iyong site	https://yourdomain.com
BACKEND_DOMAIN	API endpoint URL	https://api.yourdomain.com

Admin Panel Configuration: Matapos ang paunang setup, lahat ng mga setting ay maaaring pamahalaan sa pamamagitan ng admin panel sa /admin → Settings

Susunod na mga Hakbang

Ngayon na mayroon ka nang naka-install na Galleria:

1. Pumunta sa /admin upang ma-access ang admin panel
2. Lumikha ng mga album at i-upload ang iyong mga larawan
3. I-customize ang iyong site sa Mga Setting (branding, SEO, wika, atbp.)
Basahin ang buong dokumentasyon
Tingnan ang source code sa GitHub