도커 볼륨 한 줄과 상태 확인 주소
n8n 설치를 2026-10-06 기준으로 빈 폴더에서 해 보니 내려받기는 30초 만에 끝났고 띄운 지 2초 만에 상태 확인 주소가 정상이라고 답했습니다. 엔에이트엔(n8n)은 여러 서비스를 이어 일을 자동으로 돌리는 도구이고, 이번에는 도커(프로그램을 상자에 담아 돌리는 도구)로 띄웠습니다.
- 한 일: 공식 이미지에 볼륨(상자 밖에 둔 저장 칸)을 붙여 띄운 뒤 상자를 지웠다가 같은 저장 칸으로 다시 띄웠습니다
- 결과: 받기 30초와 뜨기까지 2초였고 다시 띄운 뒤에도 데이터 파일이 그대로 남아 있었습니다
- 쓸모: 엔에이트엔을 처음 깔아 보는 분이나 저장 칸 줄을 넣을지 망설인 분께 맞습니다
| 확인한 것 | 2026-10-06 직접 확인한 결과 |
|---|---|
| 이미지 받기 | 30초, 크기 1.75GB |
| 받은 버전 | 2.41.7 |
| 띄운 뒤 상태 확인 | 2초 만에 200 응답, {“status”:”ok”} |
| 지우고 같은 볼륨으로 다시 띄움 | database.sqlite 를 포함한 8개 항목 그대로 |
| 볼륨 없이 띄움 | 연결된 저장 칸(마운트) 0개 |
1. n8n 설치, 무슨 일이 있었나요?
처음 설치하는 사람 입장에서 엔에이트엔을 빈 폴더부터 다시 깔아 봤습니다. 맥(macOS 27.0)과 도커 29.8.0 에서 공식 이미지를 받는 데 30초가 걸렸고 이름을 붙인 볼륨을 달아 띄우자 2초 만에 상태 확인 주소가 정상이라고 답했습니다. 로그에는 편집 화면을 열 수 있다는 “Editor is now accessible via” 줄이 찍혔고 받은 버전은 2.41.7 이었습니다.
2. 무슨 문제가 생겼나요?
설치 글마다 붙이는 옵션이 조금씩 달라서 처음 하는 사람은 어느 줄이 꼭 있어야 하는지 알기 어려운데요. 이번에 직접 걸린 곳은 세 군데였습니다.
- 볼륨 줄을 빼도 서버는 똑같이 뜹니다. 그런데 볼륨 없이 띄운 컨테이너(실행 중인 상자)를 들여다보니 연결된 저장 칸이 0개였습니다. 이 이미지는 저장 칸을 따로 정해 두지 않아서 데이터가 상자 안에만 쌓이고 상자를 지우면 워크플로(자동화 순서도)와 계정도 함께 사라집니다
- 띄우는 명령이 끝났다고 다 뜬 것은 아닙니다. 명령은 금방 돌아오지만 그 순간 서버가 요청을 받을 준비가 됐는지는 따로 확인해야 했습니다
- 로그에 낯선 경고가 섞여 나옵니다. 압축 관련 환경 변수(프로그램에 넘기는 설정값) 두 개의 기본값이 앞으로 줄어든다는 안내라서 처음 보면 오류로 착각하기 쉬울 것 같습니다
1번은 마운트 0개라는 결과에서 끌어낸 설명입니다. 워크플로를 실제로 만들어 놓고 지워 본 것은 아니어서 사라지는 장면 자체는 직접 보지 않았습니다.
3. n8n 설치, 어떻게 풀었나요?
순서를 다섯 단계로 고정하니 한 번에 끝났고 명령은 끝의 부록에 모았습니다.
- 공식 이미지를 받습니다. 공식 주소(docker.n8n.io)에서 30초 만에 받았고 디스크에서 1.75GB 를 차지했습니다. 용량이 빠듯하면 도커 이미지 용량 정리부터 해 두면 편합니다
- 이름 붙인 볼륨을 먼저 만들고 그 볼륨을 달아 띄웁니다. 엔에이트엔이 데이터를 쓰는 폴더를 이 볼륨에 잇는 한 줄이 2장의 1번 문제를 막습니다
- 상태 확인 주소로 떴는지 봅니다. 띄운 뒤 healthz 주소가 2초 만에 200 과 {“status”:”ok”} 를 돌려줬고 첫 화면 주소도 200 이었습니다. 이 응답이 오면 브라우저로 5678 포트를 열 차례입니다
- 지웠다 다시 띄워 데이터가 남는지 확인합니다. 컨테이너를 지우고 같은 볼륨으로 다시 띄우자 데이터베이스 파일(database.sqlite)과 설정 폴더를 포함한 8개 항목이 그대로 있었습니다
- 압축 경고는 지금 고칠 오류가 아닙니다. 로그 원문은 두 설정의 기본값이 다음 버전에서 2 GiB 에서 256 MiB 로, 5000 에서 1000 으로 줄어든다며 지금 한도를 유지하려면 값을 직접 넣으라고 안내합니다. 이 경고가 있어도 서버는 정상으로 떴습니다
이번 n8n 설치에서는 소유자 계정을 만드는 첫 화면까지는 진행하지 않았습니다. 설치 방식별 옵션은 n8n 공식 도커 설치 문서에서 확인할 수 있습니다.
4. 누구에게 도움이 되나요?
엔에이트엔을 처음 깔면서 볼륨 줄을 넣을지 말지 망설인 분이라면 읽어 보세요. 이미 볼륨을 붙여 쓰고 있다면 4번 단계처럼 한 번 지웠다 다시 띄워 데이터가 남는지만 확인하면 됩니다.
상태 확인 200 은 서버가 떴다는 뜻이지 워크플로가 제대로 돈다는 뜻은 아닙니다. 자동화를 붙인 뒤 끝났다고 볼 기준은 AI 자동화 완료 조건에 적었고 검사는 통과했는데 실제 데이터에서 틀렸던 기록은 바이브 코딩 현실, 테스트는 통과했는데 261편 중 6편만 맞았다에 있습니다.
5. 한 줄 정리
필자의 결론
n8n 설치에서 빼면 안 되는 것은 이름 붙인 볼륨 한 줄이고 떴는지는 상태 확인 주소의 200 으로 판단하면 됩니다. 볼륨을 붙였을 때는 컨테이너를 지워도 데이터 파일이 남았고 볼륨 없이 띄운 컨테이너는 저장 칸이 0개였습니다. 그래서 필자는 컨테이너를 지울 일이 생겨도 볼륨은 남겨 두기로 했습니다.
그래서 당신은 이것만 하면 됩니다. 띄우는 명령에 볼륨 한 줄을 넣고 띄운 뒤 상태 확인 주소가 {“status”:”ok”} 를 돌려주는지 확인해 보세요.
여러분은 엔에이트엔을 어떤 방식으로 설치하셨는지 댓글로 들려주세요.
부록: 재현 명령과 출력
2026-10-06 macOS 27.0 과 Docker 29.8.0 의 빈 폴더에서 돌렸습니다. 컨테이너와 볼륨 이름은 읽기 쉽게 바꿔 적었습니다.
docker pull docker.n8n.io/n8nio/n8n
docker volume create n8n_data
docker run -d --name n8n -p 5678:5678 -v n8n_data:/home/node/.n8n docker.n8n.io/n8nio/n8n
curl -s http://localhost:5678/healthz받기는 time 으로 잰 30초였고 docker image ls 의 크기는 1.75GB 였습니다. 띄운 뒤 2초에 아래 응답을 받았습니다.
$ curl -s http://localhost:5678/healthz
{"status":"ok"}
$ docker exec n8n n8n --version
2.41.7로그 끝에 찍힌 압축 경고 두 줄입니다.
- N8N_COMPRESSION_NODE_MAX_DECOMPRESSED_SIZE_BYTES -> The default for this variable will be reduced from 2 GiB to 256 MiB in a future version. Set it explicitly to keep your current limit.
- N8N_COMPRESSION_NODE_MAX_ZIP_ENTRIES -> The default for this variable will be reduced from 5000 to 1000 in a future version. Set it explicitly to keep your current limit.컨테이너를 지우고(docker rm) 같은 볼륨으로 다시 띄운 뒤 데이터 폴더를 본 결과입니다. 8줄 중 앞 4줄만 옮겼고 나머지는 database.sqlite-wal 과 n8nEventLog.log 와 nodes 와 storage 였습니다.
$ docker exec n8n ls /home/node/.n8n
config
crash.journal
database.sqlite
database.sqlite-shm볼륨 없이 띄운 컨테이너는 docker inspect 의 마운트 목록이 빈 줄로 나왔습니다(0개). 워크플로를 만들어 지워 보는 시험과 소유자 계정 만들기는 하지 않았습니다.
새 글이 올라오면 Threads @wonizz.ai 에도 올립니다. 팔로우해 두면 피드에서 바로 볼 수 있습니다.