no space left on device とは、書き込む先のディスクに空きが無く、ファイルを書けずに出るエラー(ENOSPC)です。

  • エラーが出た時に、df -h・du -sh・docker system df でどこが満杯かを確かめる順
  • docker system prune・docker volume prune・image prune が何を消し、何を消さないかの違い(Docker の公式の文書の範囲で)
  • 当社の CI の作業員の機体と、AI の席を動かす機体が満杯になった記録と、消す順の決まり(社の実測 2026-10-10〜2026-11-15)

当社は開発の仕事の多くを AIエージェントの席に任せ、CI も自前の作業員で回しています。席も作業員も、試験・build・一時ファイルで毎日ディスクに書き込みます。この頁は、そのディスクが満杯になって ENOSPC が出た時に、何を見て、何から消し、何を消さなかったかの記録です。

ENOSPC の意味と、エラーが出る場所

Linux の errno の man は、ENOSPC を「No space left on device」(デバイスに空きが無い)と定めています(man7.org「errno(3)」2026-11-15 に確認)。ファイルを作る・書き足す・一時ファイルを置くといった書き込みの所で返る値で、書き込んだ道具ごとに見え方が変わります。

  • Node の道具: ENOSPC: no space left on device
  • Docker の build や試験の中: no space left on device で手順が落ちる
  • git: Out of diskspace などで commit が通らない

当社では、この 3 つが全部、同じ「ディスクが満杯」から出ました。席の一時ファイルが作れず、シェル 1 本も撃てなくなった事もあります(社の実測 2026-11-08・2026-11-13)。

どこが満杯かを、df と du で先に確かめる

消す前に、どのディスクのどの置き場が膨らんでいるかを確かめます。当てずっぽうで消すと、膨らんでいない所を消して空きが戻らず、要る物だけを失います。

  1. df -h で、どのファイルシステムが何 % 使われているかを見る
  2. du -sh <置き場>/* で、そのファイルシステムの中の大きい置き場を順に掘る
  3. Docker が絡むなら docker system df で、image・container・volume・build の控え(build cache)ごとの量と、回収できる量(RECLAIMABLE)を見る。-v で 1 つずつの内訳が出る(Docker「docker system df」2026-11-15 に確認)

Docker を仮想機(colima など)の中で動かしている時は、満杯になるのは手元の Mac ではなく仮想機の中のディスクです。当社の CI の作業員では、仮想機の中の /var/lib/docker が 99% になっていました(社の実測 2026-10-10)。手元の df だけを見ても気づけません。

docker prune の違い: system・volume・image で消える物

Docker の公式の文書では、prune は使われていない物をまとめて消す命令で、種類ごとに分かれています(Docker「Prune unused Docker objects」2026-11-15 に確認)。消える範囲が違うので、どれを撃つかは docker system df で膨らんでいる種類を見てから決めます。

命令既定で消える物既定では消えない物
docker system prune
止まった container・使われていない network・名無し(dangling)の image・build の控え
volume(--volumes を付けた時だけ消す)。使われていない名前付きの image は -a を付けた時だけ
docker volume prune
どの container にも使われていない名無し(anonymous)の volume
名前付きの volume(-a を付けた時だけ消す)
docker image prune
名無し(dangling)の image
タグの付いた image(-a で container に使われていない image を全部消す)
docker system df
何も消さない(量を見るだけ)
―

出典: Docker「Prune unused Docker objects」「docker system prune」「docker volume prune」「docker system df」(いずれも 2026-11-15 に確認)。

volume にはデータベースの中身など、消すと戻らない物が入ります。当社は docker system prune --volumes で一度に消さず、docker system df で volume が膨らんでいると分かった時に docker volume prune を名無しの volume に絞って撃っています。

当社の記録 1: CI の作業員の Docker が満杯になった

buildkit の残骸の volume が 1,896 個たまった

2026-10-10、CI の自前の作業員(colima の中の Docker)の /var/lib/docker が 99% になり、merge の列の試験 2 本が ENOSPC で落ちました。docker system df で見ると、dind(Docker の中で動かす Docker)の buildkit の残骸の volume が 1,896 個、回収できる量が 258GB でした。docker volume prune -f を撃ち、使用率は 99% から 9% に下がりました(社の実測 2026-10-10)。作業員の仕組みそのものは CI の自前の作業員の頁にまとめています。

掃除の台本が、本番へ出す側を一度も掃除していなかった

2026-10-23、本番へ出す専用の作業員(colima の別の Docker)に名無しの volume が 462 本・45.1GB たまり、本番へ出す仕事が 2 回 ENOSPC で落ちました。原因は、掃除の台本が CI 側の Docker の文脈だけを prune していて、出す側を一度も掃除していなかった事です。

出す側で docker volume prune と docker image prune(名無し・dangling だけ)を撃ち、使用率は 96% から 35% に下がりました。名前付きの volume・走っている作業員・使い捨ての DB には触れていません。その上で、掃除の台本に出す側の prune と、ディスクの使用量の記録(5 分おき)を足しました(社の実測 2026-10-23)。

Docker の文脈(context)が複数ある機体では、prune はその時の文脈の Docker にしか効きません。掃除の台本が全部の文脈を回っているかを確かめます。

当社の記録 2: AI の席を動かす Mac が満杯になった

AI の席を動かす機体(Mac Studio)では、Docker ではなく機体そのものの起動ボリュームが満杯になりました。

日付空き起きた事膨らんでいた物(du の内訳)撃った事
2026-11-08
141MiB(926GiB 中 891GiB 使用・100%)
一時ファイルが作れず席のシェルが撃てない。席を管理する道具も「ENOSPC: no space left on device」で起動に失敗
仮想機の置き場 170GB・作業場 116GB・AI の席の一時ファイル(/private/tmp の下)44GB・~/Library/Caches 21GB
内訳を出して、消す順を決めた
2026-11-09
72GB
―
jest の控え 34GB・node のコンパイルの控え 10GB
作り直せる控え 2 つを、一覧を出してから 1 本ずつ消すと決めた。空きの見張りと掃除の便を作る
2026-11-13
217MB
全部の席のシェルと git commit が ENOSPC(Out of diskspace)
AI の席の一時ファイル 44GB(24 時間以上触られていない一時の置き場 2,930 本・42.5GB)・仮想機 58GB・~/.cache 54GB
24 時間以上触られていない一時の置き場を固定の一覧で 1 本ずつ消し、空き 40GiB
2026-11-14
18.6GB・6.8GB・2.0GB・12.2GB(赤が 1 日に何度も)
空きの見張り(赤=空き 25GB 未満)が赤を出し続けた
jest の控え・node のコンパイルの控え・npm の控え(~/.npm/_cacache)・~/.cache の gh と uv
赤のたびに控えの掃除を撃った。控えだけでは赤が抜けず、控え以外の大物は人が判断して消す側に回した
2026-11-15
139.5GB
週の掃除の後
―
―

出典: 社の実測 2026-11-08・2026-11-09・2026-11-13・2026-11-14・2026-11-15。

根は、閉じた席の一時の置き場が消えずに残る事だった

2026-11-13 の満杯の根は、席の一時の置き場が、席が閉じた後も消えずに残り、3 日で 40GB を超えて溜まる事でした(社の実測 2026-11-13)。席を多く同時に動かす形では、1 席あたりは小さくても、閉じた席の残りが積み上がります。席を並べて動かす形は Claude Code の並列実行の頁にまとめています。

消す時は、24 時間以上触られていない一時の置き場だけを固定の一覧に書き出し、撃つ直前に 24 時間以内の更新が無い事を照らし直してから、1 本ずつ消しました。一覧を作った後に席が使い始めた置き場を、巻き込まないためです(社の実測 2026-11-13)。

消す順の決まり: 作り直せる控えから、1 本ずつ

ここまでの記録から、当社が決めた消す順を並べます(社の実測 2026-11-08〜2026-11-15)。

物当社の扱いわけ
名無しの volume・dangling の image(Docker)
prune で消す
どの container にも使われていない残骸。名前付きの volume と走っている物は残る
jest・node のコンパイル・npm・gh・uv の控え
席が一覧を出してから 1 本ずつ消す
作り直せる。消しても次の撃ちが遅くなるだけ
npm の install が走っている間の npm の控え
飛ばす
走っている物が掴んでいる控えを消すと、その install が壊れる
24 時間以上触られていない席の一時の置き場
固定の一覧で 1 本ずつ消す。撃つ直前に更新が無い事を照らし直す
閉じた席の残り。使っている席の物を巻き込まない
仮想機の置き場・作業場
席は勝手に消さない。人が判断する
作り直せない物・持ち主の判断が要る物が入っている

どれも一括では消しません。rm -rf を wildcard で撃つと、一覧に無い物まで巻き込みます。一覧を出す、照らす、1 本ずつ消す、の順を崩さない事が、満杯の時ほど効きました(社の実測 2026-11-08〜2026-11-15)。

満杯を繰り返さないための見張り

ENOSPC は、出た時には既にシェルも commit も撃てない事があります。当社は満杯になる前に気づくための仕掛けを足しました。

  • CI の本番へ出す側: 掃除の台本に出す側の prune を足し、ディスクの使用量を 5 分おきに記録する(社の実測 2026-10-23)
  • AI の席を動かす機体: 空きの見張りを置き、空き 25GB 未満を赤として、赤のたびに作り直せる控えの掃除を撃つ(社の実測 2026-11-09・2026-11-14)
  • 控えの掃除だけで赤が抜けない時は、控え以外の大物(仮想機・作業場)を人の判断に回す(社の実測 2026-11-14)

見張りや掃除の便を mac で常駐させる仕組みは launchd の頁にまとめています。

よくある質問

no space left on device が出たら、まず何をすればいいですか?

df -h でどのファイルシステムが満杯かを見て、du -sh でその中の大きい置き場を掘ります。Docker を仮想機の中で動かしているなら、仮想機の中のディスクと docker system df も見ます。消すのはどこが膨らんでいるかが分かってからです。

docker system prune と docker volume prune はどう違いますか?

docker system prune は止まった container・使われていない network・dangling の image・build の控えを消し、volume は --volumes を付けた時だけ消します。docker volume prune は使われていない volume だけを消し、既定では名無しの volume に絞られます(Docker の公式の文書・2026-11-15 に確認)。

docker prune を撃っても空きが戻らないのはなぜですか?

膨らんでいるのが Docker 以外の置き場か、別の Docker の文脈の可能性があります。当社では、掃除の台本が CI 側の Docker だけを prune していて、本番へ出す側の Docker に名無しの volume が 45.1GB たまっていました(社の実測 2026-10-23)。

ENOSPC はディスクの空きがあるのに出ることはありますか?

ENOSPC は「デバイスに空きが無い」を表す errno で(man7.org「errno(3)」)、どのデバイスかは書き込んだ先で決まります。手元の Mac に空きがあっても、Docker を動かす仮想機の中のディスクが満杯なら Docker の中では ENOSPC が出ます。当社の CI の作業員では、仮想機の中の /var/lib/docker が 99% でした(社の実測 2026-10-10)。

出典

  1. Docker「Prune unused Docker objects」https://docs.docker.com/engine/manage-resources/pruning/ (2026-11-15 に確認)
  2. Docker「docker system prune」https://docs.docker.com/reference/cli/docker/system/prune/ (2026-11-15 に確認)
  3. Docker「docker volume prune」https://docs.docker.com/reference/cli/docker/volume/prune/ (2026-11-15 に確認)
  4. Docker「docker system df」https://docs.docker.com/reference/cli/docker/system/df/ (2026-11-15 に確認)
  5. man7.org「errno(3) — Linux manual page」https://man7.org/linux/man-pages/man3/errno.3.html (2026-11-15 に確認)
  6. 社の実測 2026-10-10〜2026-11-15(当社の CI の作業員の機体と、AI の席を動かす機体のディスクの記録)