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

必要なもの

• Linux サーバー（始めるなら 1 CPU／2 GB RAM で十分です）と Docker Engine + Compose。イメージ foliowriter/folio-web は amd64 と arm64 向けに公開されています。
• サーバーを指すドメインまたはサブドメインと、開放されたポート 80/443（LAN や localhost での試用なら不要）。

最初の（管理者）アカウント

FOLIO_ADMIN_EMAILS に自分のメールアドレスを入れてサーバーを起動します。

FOLIO_DOMAIN=folio.example.com FOLIO_ADMIN_EMAILS=you@example.com \
  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
FOLIO_ADMIN_EMAILS=you@example.com
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 を実行するだけです。