n8nのDockerでファイル書き込みできない原因と解決手順【The file is not writable】

environmentセクションに以下を追加します。この設定がなければ他の手順を全部やっても解決しません。

environment:
  - N8N_RESTRICT_FILE_ACCESS_TO=/files
  - N8N_FILESYSTEM_ALLOW_WRITE=/files

手順4：コンテナを再起動する

docker compose -f /root/n8n/docker-compose.yml up -d

手順5：n8nノードのFile Pathを更新する

Read/Write Files from DiskノードのFile Path and Nameを以下のように変更します。

/files/sessions/session_{{ $json.ts }}.json

この設定でExecute stepを実行すると、正常に書き込みができるようになります。

実際に動いた構成（docker-compose.yml）

参考までに、私の環境で動作確認済みのdocker-compose.ymlを掲載します。ご自身の環境に合わせて必要な部分だけ使ってください。

services:
  n8n:
    image: n8nio/n8n
    restart: always
    ports:
      - "5678:5678"
    environment:
      - N8N_HOST=your-domain.com
      - N8N_PORT=5678
      - N8N_PROTOCOL=https
      - WEBHOOK_URL=https://your-domain.com/
      - N8N_SECURE_COOKIE=true
      - N8N_RESTRICT_FILE_ACCESS_TO=/files        # 追加
      - N8N_FILESYSTEM_ALLOW_WRITE=/files          # 追加
    volumes:
      - n8n_data:/home/node/.n8n
      - /root/n8n/files:/files                     # 追加
volumes:
  n8n_data:

version: '3.8'は削除しています。最新のDocker Composeではobsoleteの警告が出るためです。

環境：n8n 2.17.7・Docker・Ubuntu 24・Hetzner VPS

ハマりやすいポイント3つ

同じところで詰まりやすいポイントをまとめます。どれも私が実際に踏んだものです。

① `/home/node/.n8n`に書こうとして失敗するケース

ここはn8nの内部データ用のパスです。セッションファイルや自作JSONを置こうとすると権限の問題が複雑になるため、別のマウントポイント（/filesなど）を用意するのが確実です。

確認項目：書き込み先は/home/node/.n8nか → YESなら別のマウントポイントを用意する

② `filesystem-v2`バイナリモードとの混同

Codeノードからバイナリデータを直接読もうとすると、dataフィールドに"filesystem-v2"という文字列が入っていて中身が取れないことがあります。バイナリの読み書きはRead/Write Filesノードに任せる設計にするのが無難です。

確認項目：Codeノードでバイナリを直接パースしようとしているか → YESならRead/Write Filesノードを使う

③ UID不一致でchownが効かないケース

ホスト側でchown 1000:1000を実行しても、コンテナ内のユーザーのUIDが異なる場合は効きません。以下で実際のUIDを確認してから設定してください。

docker exec n8n-n8n-1 id

uid=1000(node)と表示されれば1000で合っています。

この後どうなったか

書き込みが成功した後、同じ設計でセッションデータの読み込みも実装できました。フロー間でのデータ受け渡しが安定して動くようになり、n8nのWebhook受信→本文生成→WordPress自動投稿というパイプライン全体が動き始めています。

/files配下はDockerの再起動後も消えずに残るため、セッション管理用のJSONファイル置き場として安定して使えています。現在はこの設計で問題は出ていません。

まとめ

The file is not writableエラーの原因と解決をまとめます。

• 原因：n8nのDocker環境が持つ内部のファイルアクセス制限
• 解決：専用ボリュームマウントの追加 + N8N_RESTRICT_FILE_ACCESS_TOの設定
• 注意：OS権限（chmod/chown）は直接の原因ではない

今日できる一歩は、docker-compose.ymlに/root/n8n/files:/filesのボリューム行を1行追加して再起動することです。まずそれだけ試してみてください。