How to Install CodiMD on Coolify

How to Install CodiMD on Coolify

CodiMD를 Coolify로 간편하게 설치해본 후기

예전에 자주 사용하던 HedgeDoc의 어미 격인 CodiMD를 오랜만에 다시 설치해봤습니다. 예전에는 시놀로지 NAS에 직접 올릴 때 정말 고생을 많이 했었는데, 이번에는 Coolify를 통해 너무나도 쉽게 설치할 수 있어서 허탈할 정도로 놀랐습니다.


설치 방법 요약

  • Coolify에서 codimd를 검색해 선택합니다.
  • 원하는 서브도메인명을 입력하고 저장한 뒤, Deploy 버튼을 클릭합니다.
  • 초기 실행은 한 번 꼭 해줘야 합니다. (웹 서버와 데이터베이스가 생성되어야 하므로)

에러 발생 및 해결 과정

설치 후 처음 접속하면 화면이 제대로 표시되지 않거나 깨진 것처럼 보일 수 있습니다.
이럴 때는 아래와 같이 환경변수(ENV)를 수정해주면 됩니다.

  1. Coolify의 서비스 설정에서 PROTOCOL_USESSL 값을 false에서 true로 변경합니다.
  2. 변경 사항을 저장한 뒤, 컨테이너를 재시작(reset)합니다.

이 과정을 거치면 화면이 정상적으로 출력됩니다.

추가 사용자 등록 제한하기

초기 사용자 등록을 마친 후, 더 이상 외부에서 회원 가입을 받고 싶지 않다면
환경변수에서 CMD_ALLOW_EMAIL_REGISTER 값을 true에서 false로 변경한 뒤 저장하고, 컨테이너를 다시 리셋하면 됩니다.


나만의 웹 마크다운 플랫폼

이렇게 간단하게 나만의 웹 기반 마크다운 에디터를 구축할 수 있다는 점이 정말 인상적입니다.


Coolify 덕분에 예전의 번거로움이 싹 사라졌네요.


이제는 개인 지식 관리, 협업 문서 작성 등 다양한 용도로 마음껏 활용할 수 있을 것 같습니다.