1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Evernoteの9,000件超のノートをJoplin Serverにセルフホスト移行した話

1
Last updated at Posted at 2026-04-29

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)。

参考: PostgreSQL公式 - SQL Dump / Restoring the Dump

ENEXファイル(export/)も保持しているため、最悪の場合はゼロからの再インポートも可能です。

移行して感じたこと

良かった点:

  • データが完全に自分の管理下にある安心感
  • Markdownベースなので、将来また別のツールに移行する際もハードルが低い
  • セルフホストなのでランニングコストは実質ゼロ(VPS運用でも月数百円程度)

注意点:

  • EvernoteのWebクリップは完全な再現にはならない(HTMLからMarkdownへの変換で色・フォントサイズは失われる。詳細)
  • ノート間リンクは完全には移行されない(Joplinはタイトルベースでリンク先を推測するため。詳細)
  • OCRはJoplin側で再スキャンが必要(Evernoteの認識データは移行されないが、Joplinで再生成される。詳細)
  • Joplin Serverは個人非商用利用のみ無料(商用利用にはLicensorの書面による許可が必要。ライセンス全文)

まとめ

Evernoteからの移行は、ツールさえ揃えば半日で完了します。最大のハードルはEvernote APIのレートリミットと、ENEXファイル内の壊れたHTMLですが、どちらも致命的ではありません。

10年以上、18年分のデータを自分の手元に取り戻せたのは、精神的にもすっきりしました。

出典・参考リンク

1
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?