[General] Windows에서 Plane 서비스 Docker로 로컬 실행하기

Plane은 오픈소스로 제공되는 프로젝트 관리 도구입니다. Notion과 Linear의 장점을 합쳐 만든 이 툴은 직접 서버에 설치하여 사용할 수 있는 Self-hosted 기능도 제공하는데요. 이 글에서는 Windows 환경에서 Docker를 사용해 Plane 서비스를 로컬에서 실행하는 방법을 단계별로 소개합니다.

사전 준비 사항

Plane을 실행하기 위해 아래 소프트웨어가 사전에 설치되어 있어야 합니다.

• Docker Desktop (WSL2 백엔드 사용)
• Git
• (선택) WSL2 리눅스 환경 – 설치 스크립트 실행 시 필요

설치 및 실행 절차

1. Plane 저장소 클론

git clone https://github.com/makeplane/plane.git
cd plane

2. 설치 스크립트 실행 (WSL2 환경 권장)

./setup.sh

• 설치 진행 옵션을 선택하면 plane-app 디렉토리가 생성됩니다.
• 내부에 docker-compose.yml, plane.env 파일이 자동으로 구성됩니다.

3. 수동 설치 (Windows PowerShell 사용 시)

WSL 없이 Windows PowerShell만 사용하는 경우 아래 방식으로 구성 가능합니다.

cd plane/deployment/docker-compose
Copy-Item .\plane.env.template .\plane.env

환경 변수 수정

plane.env 파일을 열어 다음과 같이 설정합니다:

NGINX_PORT=8080
WEB_URL=http://localhost:8080

4. Docker Compose로 실행

docker-compose --env-file .\plane.env up -d

• 첫 실행 시 이미지 다운로드와 초기 설정으로 수 분 소요될 수 있습니다.

5. 브라우저에서 접속 확인

웹 브라우저를 열고 아래 주소로 접속합니다:

http://localhost:8080

정상적으로 접속되면 Plane 서비스 실행이 완료된 것입니다.

자주 사용하는 명령어

# 서비스 중지
docker-compose down

# 로그 확인
docker-compose logs -f

# 서비스 재시작
docker-compose restart

마무리

Plane은 협업과 프로젝트 관리를 위해 매우 유용한 오픈소스 툴입니다. Docker로 간편하게 로컬에서 실행할 수 있기 때문에 팀원 간 테스트, 개인용 설치 등에 활용하기 좋습니다. 추후 외부 도메인 연결, HTTPS 인증서 적용 등의 고급 설정도 이어서 다뤄보겠습니다.