{{tag>[docker cli volume storage]}}

====== Docker Volume ======
컨테이너 생명주기와 분리된 영속 데이터를 관리하는 ''docker volume'' 명령 그룹.

===== Summary =====
  * named volume은 컨테이너를 다시 만들어도 유지된다.
  * bind mount와 달리 volume은 Docker가 저장 위치를 관리한다.
  * ''prune'' 는 어떤 컨테이너도 쓰지 않는 local volume을 정리한다.

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

===== Command Groups =====
  * ''create'': 새 volume 생성
    * 주요 옵션: ''-d'', ''-o'', ''--label'', ''--name''
  * ''ls'': volume 목록 조회
    * 주요 옵션: ''--filter'', ''--format'', ''-q''
  * ''inspect'': 마운트 지점과 driver 정보 확인
    * 주요 옵션: ''-f''
  * ''rm'': 사용하지 않는 volume 제거
    * 주요 옵션: ''-f''
  * ''prune'': 미사용 local volume 정리
    * 주요 옵션: ''-f'', ''--filter label=...''
  * ''update'': cluster volume 전용 설정 갱신

===== Examples =====
<code bash>
# 앱 데이터 volume 생성
docker volume create app-data

# 컨테이너에 마운트
docker run -d --name db -v app-data:/var/lib/postgresql/data postgres:17

# 실제 저장 경로 확인
docker volume inspect app-data
</code>

===== Troubleshooting =====
  * ''rm'' 이 실패하면 해당 volume을 잡고 있는 컨테이너가 남아 있을 수 있다.
  * bind mount처럼 호스트 경로를 직접 제어해야 하면 ''-v /host:/container'' 또는 ''--mount type=bind'' 를 고려한다.
  * 운영 데이터가 있는 호스트에서는 ''prune'' 전에 반드시 목록을 확인한다.

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

Manage volumes

Commands:
  create      Create a volume
  inspect     Display detailed information on one or more volumes
  ls          List volumes
  prune       Remove unused local volumes
  rm          Remove one or more volumes
  update      Update a volume (cluster volumes only)

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

===== See Also =====
  * [[docker:ko]]
  * [[docker:container]]
  * [[docker:path:var:lib:docker:containers]]

===== History =====
  * codex:: 2026-07-06 Added docker volume subpage with volume lifecycle and prune cautions.