설치

Docker 또는 개발 모드로 몇 분 안에 Galleria 사진 포트폴리오를 시작하세요.

전제 조건

시작하기 전에 다음 중 하나를 가지고 있는지 확인하세요:

  • Docker 배포(권장): Docker & Docker Compose
  • 개발용: Node.js 18+ 및 npm
  • 선택 사항: Google OAuth 자격 증명(비밀번호 인증은 없어도 작동합니다)

Docker Hub로 빠른 시작

가장 빠르게 시작하는 방법은 미리 빌드된 Docker 이미지를 사용하는 것입니다.

1. Docker 이미지 가져오기

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

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

2. 데이터 디렉토리 생성

사진과 데이터베이스를 저장할 디렉토리를 만드세요:

mkdir -p ~/galleria-data

3. 컨테이너 실행

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. 사이트에 접근

브라우저를 열고 다음으로 이동하세요:

프론트엔드:http://localhost:3000
관리 패널:http://localhost:3000/admin

설정 마법사가 첫 방문 시 초기 구성 과정을 안내합니다.

개발 설정

Galleria 개발 또는 기여를 위해:

1. 저장소 복제

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

2. 의존성 설치

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

3. 개발 서버 시작

npm run dev

이것은 핫 리로드와 함께 개발 모드에서 프론트엔드와 백엔드를 모두 시작합니다.

Docker Compose 설정

Docker Compose로 소스에서 빌드하고 실행하기 위해:

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

포트 및 환경 변수를 사용자 정의하려면 docker-compose.yml을 편집하세요.

구성

구성은 환경 변수 또는 관리 패널을 통해 관리됩니다.

환경 변수

변수설명예시
DATA_DIR사진 및 데이터베이스 디렉토리/data
FRONTEND_DOMAIN사이트의 공개 URLhttps://yourdomain.com
BACKEND_DOMAINAPI 엔드포인트 URLhttps://api.yourdomain.com

관리 패널 구성: 초기 설정 후 모든 설정은 /admin → 설정에서 관리할 수 있습니다.

다음 단계

이제 Galleria가 설치되었습니다: