Plane 셀프호스팅 완전 가이드 — Docker로 Jira 대체 무료 프로젝트 관리 툴 구축 (2026)

mkdir -p /opt/plane && cd /opt/plane
curl "https://prime.plane.so/api/v2/setup/?version=v0.25.0&airgapped=false&platform=amd64" \
  -o plane.zip
unzip plane.zip && cd plane-app

# .env 심볼릭 링크 — 없으면 포트 설정이 반영되지 않음
ln -s /opt/plane/plane-app/plane.env /opt/plane/plane-app/.env

# ⚠️ 아래 세 줄은 ${APP_DOMAIN} 변수 사용 금지 — 명시적 IP/도메인 직접 입력
APP_DOMAIN=192.168.1.100
WEB_URL=http://192.168.1.100
CORS_ALLOWED_ORIGINS=http://192.168.1.100
LISTEN_HTTP_PORT=80
SITE_ADDRESS=:80

# 보안 키 — python3 -c "import secrets; print(secrets.token_hex(50))" 으로 생성
SECRET_KEY=your-50-char-random-key
LIVE_SERVER_SECRET_KEY=your-32-char-key
POSTGRES_PASSWORD=your-strong-db-pw
RABBITMQ_PASSWORD=your-strong-mq-pw
AWS_ACCESS_KEY_ID=your-minio-access-key
AWS_SECRET_ACCESS_KEY=your-minio-secret-key

# SSL 비활성 (Cloudflare 터널 사용 시 — 값 비워두기)
CERT_ACME_CA=
CERT_EMAIL=
CERT_ACME_DNS=

cat > /opt/plane/plane-app/Caddyfile << 'EOF'
(plane_proxy) {
        request_body { max_size {$FILE_SIZE_LIMIT} }
  redir /spaces /spaces/ permanent
        reverse_proxy /spaces/* space:3000
  redir /god-mode /god-mode/ permanent
        reverse_proxy /god-mode/* admin:3000
        reverse_proxy /live/* live:3000
        reverse_proxy /api/* api:8000
        reverse_proxy /auth/* api:8000
        reverse_proxy /static/* api:8000
        reverse_proxy /{$BUCKET_NAME}/* plane-minio:9000
        reverse_proxy /{$BUCKET_NAME} plane-minio:9000
        reverse_proxy /* web:3000
}
{
        servers {
                max_header_size 25MB
                client_ip_headers X-Forwarded-For X-Real-IP
                trusted_proxies static {$TRUSTED_PROXIES:0.0.0.0/0}
        }
}
{$SITE_ADDRESS} { import plane_proxy }
EOF

    ports:
      - "${LISTEN_HTTP_PORT:-80}:80"
      - "${LISTEN_HTTPS_PORT:-443}:443"
    volumes:
      - proxy_config:/config
      - proxy_data:/data
      - /opt/plane/plane-app/Caddyfile:/etc/caddy/Caddyfile:ro

docker compose up -d plane-db plane-redis plane-mq plane-minio
sleep 10
docker compose run --rm migrator
docker compose up -d

# 200이 나오면 성공
curl -s -o /dev/null -w "%{http_code}" http://192.168.1.100

# plane.env 수정
WEB_URL=https://plane.agibop.com
CORS_ALLOWED_ORIGINS=https://plane.agibop.com

# 재시작
cd /opt/plane/plane-app
docker compose down && docker compose up -d

#!/bin/bash
BACKUP_DIR="/opt/backups/plane"
DATE=$(date +%Y%m%d_%H%M%S)
mkdir -p $BACKUP_DIR

# PostgreSQL 덤프
docker exec plane-app-plane-db-1 pg_dump -U plane plane \
  | gzip > $BACKUP_DIR/plane-db-$DATE.sql.gz

# 30일 이상 백업 삭제
find $BACKUP_DIR -name "*.gz" -mtime +30 -delete
echo "✅ 백업 완료: plane-db-$DATE.sql.gz"

0 3 * * * /opt/plane/backup.sh >> /var/log/plane-backup.log 2>&1

# 전체 상태 확인
docker compose ps

# 서비스별 로그
docker compose logs --tail=50 api
docker compose logs --tail=50 proxy

# 접속 테스트
curl -s -o /dev/null -w "%{http_code}" http://192.168.1.100

# 볼륨 목록
docker volume ls | grep plane