How to Install CodiMD on Coolify

CodiMD를 Coolify로 간편하게 설치해본 후기
예전에 자주 사용하던 HedgeDoc의 어미 격인 CodiMD를 오랜만에 다시 설치해봤습니다. 예전에는 시놀로지 NAS에 직접 올릴 때 정말 고생을 많이 했었는데, 이번에는 Coolify를 통해 너무나도 쉽게 설치할 수 있어서 허탈할 정도로 놀랐습니다.
설치 방법 요약
- Coolify에서
codimd
를 검색해 선택합니다. - 원하는 서브도메인명을 입력하고 저장한 뒤, Deploy 버튼을 클릭합니다.
- 초기 실행은 한 번 꼭 해줘야 합니다. (웹 서버와 데이터베이스가 생성되어야 하므로)
에러 발생 및 해결 과정
설치 후 처음 접속하면 화면이 제대로 표시되지 않거나 깨진 것처럼 보일 수 있습니다.
이럴 때는 아래와 같이 환경변수(ENV)를 수정해주면 됩니다.
- Coolify의 서비스 설정에서
PROTOCOL_USESSL
값을false
에서true
로 변경합니다. - 변경 사항을 저장한 뒤, 컨테이너를 재시작(reset)합니다.
이 과정을 거치면 화면이 정상적으로 출력됩니다.

추가 사용자 등록 제한하기
초기 사용자 등록을 마친 후, 더 이상 외부에서 회원 가입을 받고 싶지 않다면
환경변수에서 CMD_ALLOW_EMAIL_REGISTER
값을 true
에서 false
로 변경한 뒤 저장하고, 컨테이너를 다시 리셋하면 됩니다.
나만의 웹 마크다운 플랫폼
이렇게 간단하게 나만의 웹 기반 마크다운 에디터를 구축할 수 있다는 점이 정말 인상적입니다.
Coolify 덕분에 예전의 번거로움이 싹 사라졌네요.
이제는 개인 지식 관리, 협업 문서 작성 등 다양한 용도로 마음껏 활용할 수 있을 것 같습니다.