VPSでChaptarrを自分で運用する方法

Chaptarr とは何か、Readarr ユーザーに必要な理由

Chaptarr は Readarr のフォークで、1 つのインスタンスからオーディオブックと電子書籍を管理します。新しいリリースを監視し、ダウンロードクライアントに送信した後、取得したファイルの名前を変更してライブラリに整理します。再生機能はないため、Audiobookshelf などのプレーヤーと組み合わせて使用します。

Readarr は 2025 年 6 月 27 日に開発終了となりました。Servarr チーム自身の告知では、プロジェクトのメタデータが利用できない状態になり、Open Library への移行を進めるコミュニティの取り組みも停滞したことが理由として説明されています。リポジトリはアーカイブされています。その結果、書籍やオーディオブックのコレクションには、保守されている管理ツールがなくなりました。Chaptarr がその役割を引き継ぎました。Sonarr や Radarr で使い慣れている構成（インデクサー、ダウンロードクライアント、品質プロファイル、ルートフォルダー）を維持しつつ、ナレーターを考慮した整理、1 タイトルの複数エディション、M4B とチャプター分割 MP3 のサポート、MP3 から M4B への変換といったオーディオブック向けの機能を追加しています。

この手順では、chaptarr/chaptarr:0.9.925 のイメージタグを使用しました。これは 2026 年 8 月 9 日時点で最新のリリースでした。Chaptarr は自らをベータ版ソフトウェアと位置付けています。置き換えられないライブラリを登録する前に、末尾付近の保守に関するセクションを確認してください。

開始前に必要なもの

Docker と Compose plugin が稼働している VPS と、ライブラリを保存するための十分なディスク容量が必要です。オーディオブックは容量が大きく、hardlink を使用できない import では、一時的にファイルが 2 つ保存されます。これについては、下記の volume セクションで説明します。まだ Docker が VPS にインストールされていない場合は、VPS に Docker をインストールして稼働させるから始めてください。その後、ここに戻ります。

現在、Chaptarr は Docker image としてのみ提供されています。native Windows build は開発中として掲載されており、distribution package はありません。container はデフォルトで /config に SQLite データベースを保存します。すでに PostgreSQL server を運用している場合は、Chaptarr__Postgres__* environment variables を使用して外部の PostgreSQL server に接続できます。1 台のサーバーで 1 ユーザーが使用する場合は、SQLite が適しています。

Chaptarr の Compose サービス

このサービスは既存のスタックに組み込みます。リリース済みのタグを固定し、Web UI は loopback のみで公開し、ダウンロードクライアントがすでに使用しているネットワークに接続します。

services:
  chaptarr:
    image: chaptarr/chaptarr:0.9.925
    container_name: chaptarr
    environment:
      - PUID=1000
      - PGID=1000
      - UMASK=002
      - TZ=Europe/Berlin
    volumes:
      - ./config:/config
      - /srv/media/audiobooks:/audiobooks
      - /srv/media/ebooks:/ebooks
      - /srv/media/downloads:/downloads
    ports:
      - 127.0.0.1:8789:8789
    restart: unless-stopped
    networks:
      - arr

networks:
  arr:
    external: true

external: true の行は「このネットワークはすでに存在するため、そこに接続する」という意味です。Prowlarr と torrent クライアントが別の Compose プロジェクトにある場合に使用してください。これを指定しないと、別の Compose ファイルによって独立したネットワークが作成され、Chaptarr は名前で qbittorrent を解決できません。実際の名前は docker network ls で確認します。すでに 1 つのファイルにスタック全体が定義されている場合は、chaptarr: サービスをそのファイルに追加し、networks: ブロック全体を削除してください。全体の構成については Docker Compose で構築する完全な arr スタック、名前の規則については Compose のネットワークとサービス名の解決方法 を参照してください。

設定ディレクトリを自分で作成してから、起動します。

mkdir -p ./config
sudo chown 1000:1000 ./config
docker compose up -d
docker compose ps
docker compose logs -f chaptarr

docker compose ps の出力で、コンテナが Up と表示されることを確認します。Restarting と表示される場合は、起動に失敗して再試行中です。原因のほとんどは設定ディレクトリにあります。アプリが 8789 番ポートで待ち受けを開始すると、ログのスクロールは停止します。

PUID、PGID、Docker が root として作成するディレクトリ

PUID=99 と PGID=100 を未設定のままにすると、Chaptarr はそれぞれの既定値を使用します。これらは unRAID の値です。通常の Ubuntu VPS では、実用的なユーザーに対応しないため、ログインユーザーが書き込めない所有者のファイルが作成されます。id -u と id -g で自分の番号を確認し、その値をファイルに設定してください。

同じファイルにアクセスするすべてのコンテナで、同じ組み合わせが必要です。ダウンロードクライアントは /srv/media/downloads に書き込み、Chaptarr はファイルを /srv/media/audiobooks に移動し、プレーヤーはそこで読み取ります。ダウンロードクライアントが 1000:1000 として書き込み、Chaptarr が 99:100 として実行される場合、Chaptarr は自分が所有していないファイルを削除または移動できないため、インポートに失敗します。UMASK=002 により、新しいファイルがグループから書き込み可能になります。複数のコンテナで同じメディアグループを共有する場合は、この設定が必要です。完全な対応関係は、PUID と PGID がコンテナユーザーをホスト上のファイルに対応付ける方法に記載されています。

README では、特定の注意点が示されています。重要なので、ここでも説明します。docker compose up を実行した時点で ./config が存在しない場合、Docker はそのディレクトリを root:root が所有する状態で作成します。コンテナは UID 1000 として実行されるため、自身のデータベースに書き込めず、終了と再起動を繰り返します。ls -ln ./config で確認してください。このコマンドは、名前ではなく数値の所有者を表示します。2 つの 0 は、root が所有者であることを示します。sudo chown -R 1000:1000 ./config で修正してから、コンテナを再起動してください。

オーディオブック用と電子書籍用のボリュームを分けるとハードリンクが使えない理由

上記の構成では、プロジェクト独自の実行コマンドに合わせて、/audiobooks、/ebooks、/downloadsを別々の bind としてマウントしています。読みやすい構成ですが、実際の問題が1つあります。ハードリンクが使えなくなります。

ハードリンクは、ディスク上の同じデータに対する2つ目の名前です。追加の容量を使わず、処理も即時に完了するため、arr ファミリーではコピーよりハードリンクが推奨されます。ハードリンクは、1つのファイルシステム内でのみ機能します。コンテナ内ではこれらが3つの別々のマウントポイントになっているため、ホスト側のパスが同じディスク上にあっても、カーネルはリンクの作成を拒否します。実際に確認してください。

docker exec chaptarr sh -c 'touch /downloads/linktest && ln /downloads/linktest /audiobooks/linktest'

このコマンドは、Invalid cross-device linkで終わるエラーを出して失敗します。これはカーネルがマウントポイントをまたぐリンクを拒否しているためであり、Chaptarr がファイルのコピーに切り替える正確な理由です。コピーは正しく動作しますが、処理は遅くなります。また、トレントを削除するまでオーディオブックが2つ存在する状態になります。シード中はトレントを削除しないため、この状態が続きます。その後、/srv/media/downloads/linktestを削除してください。

ハードリンクを使うには、親ディレクトリを1つマウントします。

    volumes:
      - ./config:/config
      - /srv/media:/data

次に、Chaptarr のルートフォルダーを /data/audiobooks と /data/ebooks に設定し、ダウンロードクライアントにも同じ /srv/media:/data マウントを割り当てます。これにより、両方のコンテナから同一のパスが見えるようになります。まず、ホスト側が単一のファイルシステムであることを確認してください。df -h /srv/media/downloads /srv/media/audiobooksを実行し、両方で Filesystem 列に同じ値が表示される必要があります。値が異なる場合はディスクが異なるため、どのようなマウント構成でもそれらをまたぐハードリンクは作成できません。これと名前付きストレージのトレードオフについては、メディア用の bind mount と名前付きボリュームの比較で説明しています。

Web UI に外部公開せずアクセスする

ポートの行で 127.0.0.1 を指定しているのには理由があります。ufw deny 8789 では公開済みの Docker ポートを保護できません。Docker は独自の NAT（network address translation）ルールを、ufw のルールより先にカーネルが処理するチェーンへ書き込むためです。そのため、トラフィックはルールが確認される前に転送されます。この動作は頻繁に見落とされます。詳しくは 公開した Docker ポートが ufw のルールを無視する理由 を参照してください。loopback にバインドすれば、この問題を完全に回避できます。

自分のマシンから SSH トンネル経由で UI にアクセスします。

ssh -N -L 8789:127.0.0.1:8789 you@your-server

この状態で実行したままにし、ブラウザーで http://127.0.0.1:8789 を開きます。初回起動時に認証を設定してください。その後で初めて、前段に TLS（transport layer security）対応のリバースプロキシを置くことを検討します。このようなツールを 3 つまたは 4 つ運用し、それぞれに別のパスワードを設定して SSH トンネルでアクセスするようになると、より整理された方法は、プロキシの背後に Authentik などの自己ホスト型シングルサインオンサーバーを置くことです。1 回のログインですべてのアプリを利用でき、1 回の無効化ですべてのアクセスを停止できます。

インデクサーとダウンロードクライアントを接続する

Chaptarr は標準の arr インデクサーおよびダウンロードクライアントのプロトコルに対応しています。そのため、Prowlarr は Sonarr と同じ方法でインデクサーを Chaptarr に登録できます。通常の torrent クライアントや usenet クライアントも、特別な設定なしで接続できます。

ほとんどの環境で問題になる設定が 1 つあります。Chaptarr からダウンロードクライアントのホストを指定するときは、localhost や 127.0.0.1 を入力しないでください。コンテナ内では、そのアドレスはコンテナ自身を指します。そのため Chaptarr は自身のポート 8080 に接続しようとし、接続できないと報告します。代わりに、コンテナ名の qbittorrent とポート 8080 を使用します。docker network inspect arr を実行して、両方のコンテナが同じネットワーク上にあることを確認してください。このコマンドでは、接続されているすべてのコンテナが名前付きで一覧表示されます。

ダウンロードクライアントが network_mode: "service:gluetun" を使用して VPN コンテナ経由で動作している場合、そのクライアントはネットワーク上に独自の名前を持ちません。Gluetun のネットワーク名前空間を共有するためです。Gluetun が公開しているポートで、gluetun として接続します。この構成と、それに伴うルーティングについては、Gluetun 経由でダウンロードクライアントをルーティングするを参照してください。

Readarr からの移行で発生すること

Chaptarr は Readarr のメタデータソースと互換性がありません。複数のプロバイダーを使う独自の処理パイプラインでタイトル、著者、エディションを解決するため、Readarr が保存した識別子は Chaptarr では意味を持ちません。データベースのインポート機能はなく、そのまま置き換えるアップグレード経路もありません。

既存のライブラリでは、ファイルはそのまま利用できますが、設定は引き継げません。この処理でディスク上の既存ファイルが変更されることはありません。root folder を追加し、ライブラリのインポートを実行すると、Chaptarr は検出したファイルを独自のメタデータと照合します。手動で再構築する必要があるのは、quality profile、命名形式、indexer と client の設定、および Chaptarr が誤って照合したすべての項目です。大規模なライブラリでは手動修正が必要になるため、10 分ではなく 1 晩を見込んでください。

次の順序で実施します。Readarr コンテナを停止しますが、設定ボリュームは保持してください。以前の設定を参照しながら、Chaptarr に再入力できます。まず小さなフォルダー 1 つを Chaptarr に指定し、すべてをインポートする前に照合結果を確認します。問題がないことを確認してから、古いコンテナを削除してください。

ライブラリ全体をスキャンする前に、プライバシーに関して 1 点確認しておきます。メタデータの検索は api2.chaptarr.com に送信されます。README には、これらのリクエストにプロバイダー ID、検索文字列、メディア種別、タグ、ファイル名が含まれる場合があり、完全なパス、ユーザーの識別情報、認証情報は含まれないと記載されています。ファイル名はサーバーの外部へ送信されます。メタデータサービスでは通常の動作ですが、利用するかどうかは意図的に判断してください。

オーディオブックをプレーヤーに渡す

Chaptarr はファイルを整理します。再生は別のプログラムの役割です。通常は Audiobookshelf と組み合わせます。Audiobookshelf はデバイス間で聴取位置を追跡でき、スマートフォン用アプリもあります。公式イメージは ghcr.io/advplyr/audiobookshelf:latest です。公式の Compose 例では、ホストの 13378 番ポートをコンテナの 80 番ポートに公開します。

  audiobookshelf:
    image: ghcr.io/advplyr/audiobookshelf:latest
    container_name: audiobookshelf
    ports:
      - 127.0.0.1:13378:80
    volumes:
      - ./abs/config:/config
      - ./abs/metadata:/metadata
      - /srv/media/audiobooks:/audiobooks
    environment:
      - TZ=Europe/Berlin
    restart: unless-stopped

Chaptarr が書き込む同じホストパスをマウントし、Web UI で /audiobooks をライブラリとして追加します。次回のスキャン後に、新しいインポートが表示されます。

すでに Jellyfin を運用している場合は、そのフォルダーをライブラリとして追加して再生できます。ただし、1 つの長いオーディオブックファイルでは、専用のオーディオブックサーバーよりレジューム動作が弱くなります。Jellyfin の設定方法は、VPS で Jellyfin をメディアサーバーとして運用するで説明しています。電子書籍については、/srv/media/ebooks をリーダーアプリケーションに渡します。ファイル名を付けて所定の場所に整理した時点で、Chaptarr の役割は終わります。

保守上のリスク: ライセンス、ランタイム、頻繁に更新されるタグ

Chaptarr は GPL-3.0 ライセンスで提供されており、著作権は Chaptarr のコントリビューターに帰属します。一部には Servarr チームの成果物も含まれています。そのためコードはオープンな状態に保たれ、このメンテナーが活動を停止しても、誰でも再びフォークできます。Chaptarr は .NET 10 を基盤としており、2026 年 8 月時点でランタイムの最新の長期サポートリリースです。基盤が数か月ではなく数年間サポートされるということです。このプロジェクトが来年も存続するかを判断する場合、どちらも重要な要素です。

バージョン番号は急速に変わります。リリースはプレリリースとして公開されており、0.9.925 はこの手順と同じ日にリリースされました。正確なタグを固定してください。latest を使用すると、無人の docker compose pull によって 1 週間で複数のバージョンが更新される可能性があります。また、開発期間の短いフォークでは、リリース間で API が変更される可能性があり、それに対して作成したスクリプトやダッシュボードが動かなくなります。タグを固定する習慣は、自分でホストする開発期間の短いプロジェクトすべてに適用する価値があります。そのため、セルフホスト型のワークアウトトラッカーとして openGym を実行する手順でも、まったく同じ理由から固定した git タグを使ってデプロイしています。

アップグレードの前には必ずバックアップを取り、そのうえで意図的にアップグレードしてください。

docker compose stop chaptarr
sudo tar czf chaptarr-config-backup.tgz ./config
docker compose start chaptarr

docker compose pull chaptarr
docker compose up -d chaptarr

このプロジェクトでは、約 6 か月間、1 万 1 千人を超えるユーザーに対してデータ損失が発生していないと報告されています。それでも、バックアップを保持し、失うと困るライブラリを指定しないよう推奨しています。この 2 つをどちらも重く受け止めてください。設定アーカイブをサーバーの外部へコピーします。保護対象と同じディスクにあるバックアップは、バックアップとはいえないためです。この 1 つの tarball だけで十分なのは、Chaptarr が /config 配下の 1 つの SQLite ファイルに状態を保持しているためです。別のデータベースサーバー上にあるデータは、データベースもダンプする必要があります。これは、Postgres のデータとアップロード済みファイルを含めて VPS 上で Chatwoot をセルフホストする場合のバックアップ手順と同じ構成です。

障害パターンと表示される文字列

コンテナがループ状態で再起動する。 docker compose ps に Restarting が表示されます。ls -ln ./config を実行します。所有者列の 2 つの 0 は、Docker がディレクトリを root として作成したため、コンテナユーザーがデータベースに書き込めないことを示します。sudo chown -R 1000:1000 ./config を実行します。

インポートが完了せず、ファイルが downloads に残る。 Chaptarr はダウンロードしたファイルを読み取れますが、ライブラリに書き込めません。ls -ln /srv/media/audiobooks を PUID および PGID と比較します。別の UID が所有するディレクトリや、グループが所有していてもグループ書き込み権限がないディレクトリでは、ファイルを移動できません。UMASK=002 により、新規ファイルで後者を防げます。

インポートのたびにディスク使用量が 2 倍になる。 hardlink が作成されず、ファイルがコピーされています。volumes セクションの ln テストを実行します。Invalid cross-device link で終わるエラーが表示されれば、これが確認できます。単一の親ディレクトリをマウントする構成が解決策です。

ダウンロードクライアントに接続できない。 ホストとして localhost を入力しています。コンテナ内では、これは Chaptarr 自身を指します。コンテナ名を使用し、docker network inspect arr で両方のコンテナが一覧に表示されることを確認します。

Compose がサービスの起動を拒否する。 Bind for 127.0.0.1:8789 failed: port is already allocated は、別のプロセスがポートを使用していることを示します。sudo ss -lntp | grep 8789 で使用元を特定します。

ブラウザーに何も表示されない。 ポートを 127.0.0.1 にバインドすると、インターネット経由でラップトップから接続できる待ち受け先がありません。これは意図した動作です。最初に SSH トンネルを開きます。

FAQ

Readarr のライブラリを Chaptarr に移行できますか？

インポートとしては移行できません。Chaptarr は Readarr のメタデータソースに対応しておらず、独自のプロバイダーパイプラインを使用するため、Readarr が保存した識別子には意味がなく、データベース変換もありません。ディスク上のファイルは変更されません。同じパスを root folder として追加し、ライブラリインポートを実行して、Chaptarr 自身にファイルを照合させます。Quality profile、命名形式、indexer 設定、誤った照合結果の修正は手作業が必要です。そのため、すべてをインポートする前に小さなフォルダー1つで始めてください。

Chaptarr が audiobook フォルダーに書き込めないのはなぜですか？

コンテナのユーザーがファイルの所有者ではありません。これらの変数が未設定の場合、Chaptarr は PUID=99 と PGID=100 にフォールバックします。これらは unRAID の値であり、通常の Ubuntu VPS では正しくありません。自分の id -u と id -g を設定し、download client にも同じ組み合わせを使用して、新しいファイルがグループ書き込み可能な状態に保たれるよう UMASK=002 を設定します。ライブラリディレクトリで ls -ln を使用して所有者を確認してください。これは名前ではなく番号を出力するため、比較できます。

インポート後にディスク使用量が2倍になったのはなぜですか？

ハードリンクを作成できなかったため、Chaptarr がファイルをコピーしました。/downloads と /audiobooks を個別の bind としてマウントすると、コンテナ内では別々のマウントポイントになります。そのため、カーネルはマウントポイントをまたぐハードリンクを Invalid cross-device link で拒否します。/srv/media:/data などの親ディレクトリを1つマウントし、アプリ内ではその配下の /data/downloads と /data/audiobooks を使用してください。両方のパスが1つのホストファイルシステム上にある必要もあります。この点は df -h で確認できます。

Chaptarr で audiobook を再生できますか？

いいえ。Chaptarr は audiobook の検索、ダウンロード、名前変更、整理を行いますが、再生は別のプログラムで行います。一般的な組み合わせは Audiobookshelf です。デバイス間で再生位置を記憶でき、同じホスト上の audiobook パスをマウントして公式イメージ ghcr.io/advplyr/audiobookshelf:latest を使用します。Jellyfin でもフォルダーをライブラリとして追加すれば再生できますが、長い単一ファイルの audiobook では再生位置の復元が弱くなります。

Chaptarr を重要なライブラリで安全に実行できますか？

Chaptarr は若いフォークによるベータ版ソフトウェアです。プロジェクト自身もその点を明記しています。一方で、約6か月間、1万1千人を超えるユーザーの環境でデータ損失イベントがなかったと報告しています。安心材料は、コードをフォークできる GPL-3.0 ライセンスと、2026年8月時点で長期サポートランタイムである .NET 10 を基盤としていることです。latest ではなく 0.9.925 などの正確なイメージタグを固定し、アップグレードの前に /config をバックアップして、そのアーカイブをサーバー外に保管してください。