{{tag>[docker cli system maintenance]}}

====== Docker System ======
Docker Engine 전체 사용량, 이벤트, 정보, 공용 정리를 다루는 ''docker system'' 그룹.

===== Summary =====
  * 개별 자원 단위가 아니라 Docker 전체 관점의 상태 점검에 가깝다.
  * ''df'' 는 이미지, 컨테이너, local volume, build cache 사용량을 한 번에 보여준다.
  * ''prune'' 는 범위가 넓어 운영 환경에서는 반드시 옵션을 확인하고 사용한다.

===== Usage =====
<code bash>
docker system COMMAND
</code>

===== Command Groups =====
  * ''info'': daemon, storage driver, runtime, cgroup, plugin, 경고 상태 확인
  * ''df'': 디스크 사용량 요약
    * 주요 옵션: ''-v'', ''--format''
  * ''events'': 실시간 서버 이벤트 스트림
    * 주요 옵션: ''--filter'', ''--since'', ''--until''
  * ''prune'': 미사용 자원 정리
    * 주요 옵션: ''-a'', ''--volumes'', ''-f'', ''--filter''

===== Examples =====
<code bash>
# 전체 저장 공간 확인
docker system df -v

# 최근 이벤트 확인
docker system events --since 10m

# 주의해서 미사용 자원 정리
docker system prune -a
</code>

===== Troubleshooting =====
  * 디스크가 갑자기 줄어들면 ''docker system df -v'' 로 image layer와 build cache를 먼저 분리해서 본다.
  * ''prune'' 는 중지 컨테이너, dangling image, build cache를 제거할 수 있다. named volume은 ''--volumes'' 가 있어야 대상이 된다.
  * daemon 문제 분석은 이 그룹보다 top-level ''docker info'' 와 서비스 로그를 함께 보는 편이 낫다.

===== Help =====
+++ docker system --help |
<code text>
Usage:  docker system COMMAND

Manage Docker

Commands:
  df          Show docker disk usage
  events      Get real time events from the server
  info        Display system-wide information
  prune       Remove unused data

Run 'docker system COMMAND --help' for more information on a command.
</code>
+++

===== See Also =====
  * [[docker:ko]]
  * [[docker:builder]]
  * [[config:etc:docker:daemon.json]]

===== History =====
  * codex:: 2026-07-06 Added docker system subpage with disk-usage and prune scope notes.