Folio Writer ☰

Folio Writer Cloud 자체 호스팅

docker compose 파일 하나로 cloud.foliowriter.app을 구동하는 것과 같은 서버를 내 컴퓨터에서 실행할 수 있습니다. 실시간 공동 편집, 종단간 암호화 프로젝트, 조판 미리보기, PDF / Word / LaTeX 내보내기까지 — Pandoc과 Typst가 이미지 안에 함께 들어 있습니다. 개인 용도는 무료입니다.

mkdir folio && cd folio
curl -fsSLO https://foliowriter.app/selfhost/docker-compose.yml
FOLIO_DOMAIN=folio.example.com docker compose up -d

필요한 것

• Docker Engine + Compose가 설치된 Linux 서버. 시작하기에는 CPU 1개 / RAM 2 GB면 충분합니다. foliowriter/folio-web 이미지는 amd64와 arm64용으로 배포됩니다.
• 서버를 가리키는 도메인 또는 하위 도메인, 그리고 열려 있는 80/443 포트(LAN이나 localhost에서 시험해 볼 때는 필요 없음).

첫 번째(관리자) 계정

FOLIO_ADMIN_EMAILS에 내 이메일 주소를 넣고 서버를 시작하세요.

FOLIO_DOMAIN=folio.example.com [email protected] \
  docker compose up -d

여기에 나열된 주소는 항상 관리자입니다. 할당량 제한이 없고, /admin 대시보드(계정, 프로젝트, 저장 공간, 트래픽)도 쓸 수 있습니다. 그 이메일로 로그인하세요. SMTP가 설정되어 있지 않으면 매직 로그인 링크가 이메일로 발송되지 않고 서버 로그에 출력됩니다.

docker compose logs folio-web | grep -i http

출력된 링크를 열면 바로 로그인됩니다. 실제로 이메일을 보내려면 SMTP_* 변수를 설정하고(어떤 릴레이든 됩니다), 이메일 속 링크가 내 도메인을 쓰도록 PUBLIC_BASE_URL도 설정하세요.

구성

모든 설정은 환경 변수로 합니다. docker-compose.yml 옆의 .env 파일에 넣으세요(Compose가 자동으로 읽습니다).

FOLIO_DOMAIN=folio.example.com
PUBLIC_BASE_URL=https://folio.example.com
[email protected]
FOLIO_LIMIT_PROJECTS=0        # 0 = unlimited
FOLIO_LIMIT_STORAGE_MB=0      # 0 = unlimited
FOLIO_ENC_KEY=…               # openssl rand -hex 32

업데이트, 백업 및 복원

업데이트: docker compose pull && docker compose up -d. latest를 따라가는 대신 버전을 고정하고 싶다면 태그가 붙은 버전(foliowriter/folio-web:0.2.0)도 있습니다.

프로젝트, 계정, 세션 등 모든 것이 compose 파일 옆의 ./data에 들어 있습니다. 백업은 그 폴더 하나면 됩니다.

docker compose stop folio-web
tar czf folio-backup-$(date +%F).tgz data
docker compose start folio-web

data/를 다시 넣고 docker compose up -d를 실행하면 복원(또는 서버 이전)이 끝납니다.