For foreign readers,
I migrated 18 years of Evernote data — 38 notebooks, ~9,000 notes, ~10,000 attachments, totaling 3.2 GB — to a self-hosted Joplin Server. The motivation was Evernote's increasingly costly pricing plans.
The migration pipeline was: Evernote Cloud → evernote-backup (sync to local SQLite DB) → ENEX files → Joplin CLI (import) → Joplin Server (sync). The container runtime used was Finch (AWS's Docker-compatible open-source tool).
Joplin Server runs via Finch Compose with PostgreSQL, using a named volume for data persistence. The Joplin Server app itself is stateless; all data resides in PostgreSQL. For backups, pg_dump --clean --if-exists creates restorable SQL dumps, and the original ENEX files are retained as a fallback.
Key challenges included Evernote API rate limits during sync (~40 min wait) and malformed HTML in web clips. Both were non-fatal — evernote-backup supports incremental sync, and Joplin CLI continues importing despite HTML errors, preserving all text content.
Notable caveats: color/font formatting is lost in HTML-to-Markdown conversion, inter-note links are partially restored (title-based guessing), and OCR data must be regenerated by Joplin. Joplin Server is free for personal, non-commercial use only.
The entire process — export, server setup, import, and sync — was completed in under half a day.
はじめに
20年近く使い続けてきたEvernoteから、セルフホストのJoplin Serverへ移行しました。38ノートブック、約9,000ノート、約10,000件の添付ファイル、合計3.2GBのデータです。最も古いノートは2008年6月のもので、約18年分の蓄積になります。
移行の動機はシンプルで、Evernoteの料金プランです。かつては無料プランでも十分使えたEvernoteですが、近年の度重なるプラン改定で、自分の使い方に対してコストが見合わなくなりました。データは自分の手元に置きたい。そう思って移行を決めました。
この記事では、実際にハマったポイントも含めて、移行の全工程を共有します。
なお、本記事ではコンテナランタイムに Finch を使用しています。FinchはAWSが開発したDocker互換のオープンソースツールで、CLIの使い方はDockerとほぼ同じです。Docker環境の方は記事中の finch を docker に読み替えてください。
移行アーキテクチャ
全体の流れを図にまとめました。
使ったツール:
| ツール | 用途 |
|---|---|
| evernote-backup | EvernoteからENEX形式で一括エクスポート |
| Joplin CLI | ENEXファイルのインポート |
| Joplin Server (finch compose) | セルフホストの同期サーバー |
| 自作Pythonスクリプト群 | 自動化・検証 |
なぜJoplin Serverなのか
Joplin Serverを選んだ理由:
- EvernoteのENEX形式のインポートが公式サポートされている(Joplin公式)
- ノートブック・タグ・添付ファイル・メタデータがインポートされる(同上)
- デスクトップ・モバイルアプリが充実している
- Docker + PostgreSQLでセルフホストが容易
- クライアントアプリはオープンソース(MITライセンス)
- 個人非商用利用であれば無料(Joplin Server Personal Use License)
Step 1: Evernoteからのエクスポート
evernote-backup を使えば、3コマンドで全データをローカルにバックアップできます。
# macOSの場合(公式推奨)
brew install evernote-backup
# または pipx / uv
pipx install evernote-backup
evernote-backup init-db # OAuth認証(ブラウザが開く)
evernote-backup sync # 全ノートをローカルDBに同期
evernote-backup export output/ # ノートブック単位でENEXファイルを出力
evernote-backup はローカルにSQLiteデータベース(en_backup.db)を作成し、Evernoteの全ノートデータをここに保存します。init-db でOAuth認証とDB初期化を行い、sync でEvernote APIからノートを取得してDBに蓄積、export でDBからENEXファイルを生成します。syncは差分同期に対応しており、途中で中断しても次回は続きから再開されます。
ハマりポイント:APIレートリミット
数千件のノートを同期する途中で、Evernote APIのレートリミットに引っかかりました。
CRITICAL: Rate limit reached. Restart program in 38:31.
リミット解除を待って evernote-backup sync を再実行すれば、前回の続きから再開されます。自動化スクリプトでは、レートリミットを検知して自動で待機→リトライする処理を入れました。
ENEXファイルの構造
エクスポートされたENEXファイルの内部構造です。添付ファイルはBase64エンコードで格納されています。
<en-export>
<note>
<title>ノートのタイトル</title>
<content><![CDATA[<en-note>本文...</en-note>]]></content>
<resource>
<mime>image/jpeg</mime>
<data encoding="base64">/9j/4AAQ...</data> <!-- 添付ファイルの実データ -->
</resource>
</note>
<!-- ... 数千ノート -->
</en-export>
添付ファイル(画像・PDF等)は <resource> タグ内にBase64エンコードされた状態で含まれるため、ENEXファイルさえあれば完全に復元可能です。実際にBase64データをデコードしてJPEG画像として復元できることも確認しました。
Step 2: Joplin Serverの構築
finch compose で一発です。
services:
db:
image: postgres:16
volumes:
- pgdata:/var/lib/postgresql/data
environment:
- POSTGRES_USER=joplin
- POSTGRES_PASSWORD=<your-password>
- POSTGRES_DB=joplin
app:
image: joplin/server:latest
depends_on:
- db
ports:
- "22300:22300"
environment:
- APP_PORT=22300
- APP_BASE_URL=http://localhost:22300
- DB_CLIENT=pg
- POSTGRES_USER=joplin
- POSTGRES_PASSWORD=<your-password>
- POSTGRES_DATABASE=joplin
- POSTGRES_PORT=5432
- POSTGRES_HOST=db
volumes:
pgdata:
finch compose up -d
起動後、http://localhost:22300 にアクセスして管理者パスワードを変更しておきます(デフォルト: admin@localhost / admin。Docker Hub参照)。
データの永続化
Joplin Serverはデフォルト設定ではステートレスで、すべてのデータはPostgreSQLに格納されます(STORAGE_DRIVER 環境変数でファイルシステムやS3に保存先を変更することも可能。Docker Hub参照)。PostgreSQLのデータは joplin_pgdata という名前付きボリュームにマウントされており、コンテナを停止・再作成してもデータは保持されます。
注意:Finchユーザーの方へ
Finch は内部的に Lima(Linux VM)+ nerdctl(containerd CLI)+ BuildKit で構成されたDocker Desktop代替ツールです。Finchを使っている場合、PostgreSQLのボリュームマウントでパーミッションエラーが出ることがあります。バインドマウント(./data/postgres:/var/lib/...)ではなく、名前付きボリューム(pgdata:)を使うことで解決しました。
Step 3: ENEXファイルのインポート
Joplin CLIをインストールして、ENEXファイルをディレクトリごと一括インポートします。
# Joplin CLIのインストール(公式手順)
NPM_CONFIG_PREFIX=~/.joplin-bin npm install --loglevel=error -g joplin
sudo ln -s ~/.joplin-bin/bin/joplin /usr/local/bin/joplin
# 同期先をJoplin Serverに設定
joplin config sync.target 9
joplin config sync.9.path http://localhost:22300
joplin config sync.9.username admin@localhost
joplin config sync.9.password <your-password>
# ディレクトリ指定で全ENEXファイルを一括インポート
joplin import --format enex export/
ハマりポイント:壊れたHTML
EvernoteのWebクリップには、不正なHTMLがそのまま含まれていることがあります。Joplin CLIはエラーを出力しつつも、可能な限りインポートを続行してくれます。一部のフォーマット(色、フォントサイズなど)は失われますが、テキスト本文は保持されます。
なお、ENEXファイルのインポートはディレクトリ指定(joplin import --format enex export/)で行います。単一ファイル指定だとノートブックが正しく分かれません。
Step 4: 同期と確認
joplin sync
約9,000ノート + 約10,000添付ファイルの同期に約6分かかりました。Joplinデスクトップアプリで同期先を設定すれば、全ノートが手元で閲覧・編集できます。
移行結果
| 項目 | 数値 |
|---|---|
| ノートブック | 38 |
| ノート | 9,014 |
| 添付ファイル | 9,950 |
| タグ | 90 |
| ENEXファイル合計サイズ | 3.2 GB |
| エクスポート所要時間 | sync: 約1時間15分 + レートリミット待ち約40分、export: 約1分半 |
| インポート所要時間 | 約15分 |
| 同期所要時間 | 約6分 |
運用:起動・停止・バックアップ
移行完了後の日常運用です。
コンテナの起動・停止
./joplin.sh start # 起動
./joplin.sh stop # 停止
./joplin.sh status # 状態確認
データのバックアップ
# PostgreSQLのダンプ(--clean --if-exists でDROP IF EXISTS文を含め、リストア時の競合を防ぐ)
finch exec joplin-db-1 pg_dump --clean --if-exists -U joplin joplin > backup_joplin_$(date +%Y%m%d).sql
# リストア手順:
# 1. appコンテナのみ停止(dbは稼働させたまま)
finch stop joplin-app-1
# 2. ダンプをリストア(-X でpsqlrcを無視、--single-transaction で部分リストアを防止)
finch exec -i joplin-db-1 psql -X --single-transaction -U joplin joplin < backup_joplin_YYYYMMDD.sql
# 3. appコンテナを再起動
finch start joplin-app-1
⚠️ リストアは既存データを上書きします。
./joplin.sh stopはdbコンテナも停止するため、リストア時は上記のように appコンテナのみ を停止してください。--single-transactionにより、途中でエラーが発生した場合は全体がロールバックされます。--if-existsは--cleanと併用することで、オブジェクトが存在しない場合のDROPエラーを抑制します(PostgreSQL公式 - pg_dump)。
ENEXファイル(export/)も保持しているため、最悪の場合はゼロからの再インポートも可能です。
移行して感じたこと
良かった点:
- データが完全に自分の管理下にある安心感
- Markdownベースなので、将来また別のツールに移行する際もハードルが低い
- セルフホストなのでランニングコストは実質ゼロ(VPS運用でも月数百円程度)
注意点:
- EvernoteのWebクリップは完全な再現にはならない(HTMLからMarkdownへの変換で色・フォントサイズは失われる。詳細)
- ノート間リンクは完全には移行されない(Joplinはタイトルベースでリンク先を推測するため。詳細)
- OCRはJoplin側で再スキャンが必要(Evernoteの認識データは移行されないが、Joplinで再生成される。詳細)
- Joplin Serverは個人非商用利用のみ無料(商用利用にはLicensorの書面による許可が必要。ライセンス全文)
まとめ
Evernoteからの移行は、ツールさえ揃えば半日で完了します。最大のハードルはEvernote APIのレートリミットと、ENEXファイル内の壊れたHTMLですが、どちらも致命的ではありません。
10年以上、18年分のデータを自分の手元に取り戻せたのは、精神的にもすっきりしました。
出典・参考リンク
- Joplin公式 - Importing and exporting — ENEXインポートの仕様、変換時の制限事項
- Joplin公式 - Joplin Terminal Application — CLIのインストール、importコマンド、sync.target設定
- Joplin公式 - OCR — OCR機能の仕様
- Joplin Server - Docker Hub — Docker構築手順、デフォルト認証情報
- Joplin Server Personal Use License — ライセンス条件(個人非商用利用のみ無料)
- Joplin Client License (MIT) — クライアントアプリのライセンス
- evernote-backup - GitHub — Evernoteバックアップツール、インストール方法
- PostgreSQL公式 - SQL Dump — pg_dump/psqlによるバックアップ・リストア手順
- PostgreSQL公式 - pg_dump — pg_dumpコマンドリファレンス(--clean, --if-existsオプション)