직접 설치가 맞는지 먼저 판단합니다
서버와 Docker를 이미 운영하고 데이터 위치를 직접 통제해야 한다면 셀프호스팅의 장점이 큽니다. 반대로 리눅스 보안 업데이트, 도메인, TLS 인증서, 장애 복구가 모두 처음이라면 n8n Cloud의 월 요금이 운영 시간을 사는 비용이 될 수 있습니다.
| 상황 | 더 자연스러운 시작 | 이유 |
|---|---|---|
| 개인 학습·로컬 테스트 | Docker 셀프호스팅 | 작게 지우고 다시 만들기 쉬움 |
| 고객 업무·24시간 웹훅 | Cloud 또는 운영형 서버 | 가용성·백업 책임이 커짐 |
| 내부망·데이터 주권 요구 | 셀프호스팅 | 네트워크와 저장 위치 통제 |
| 서버 경험 없음 | Cloud | 초기 장애 지점을 줄임 |
로컬 테스트에서도 볼륨은 생략하지 않습니다
n8n 공식 문서는 Docker를 대부분의 셀프호스팅 상황에 권장합니다. 컨테이너는 교체될 수 있으므로 /home/node/.n8n을 Docker 볼륨에 연결해야 자격증명 암호화 키와 데이터가 유지됩니다.
docker volume create n8n_data
docker run --name n8n -p 5678:5678 -v n8n_data:/home/node/.n8n docker.n8n.io/n8nio/n8n
이 명령은 학습용 출발점입니다. 포트 5678을 인터넷에 그대로 공개하는 운영 구성은 아닙니다. 외부 웹훅이 필요하면 도메인, 리버스 프록시와 HTTPS를 설정하고 n8n이 외부 URL을 정확히 알도록 환경변수를 맞춰야 합니다.
운영 전 체크리스트는 컨테이너 밖에 있습니다
HTTPS와 프록시로그인·웹훅 트래픽을 암호화하고 실제 외부 주소를 설정합니다.
PostgreSQL운영 규모에서 SQLite 한계를 검토하고 외부 DB의 백업·권한을 관리합니다.
암호화 키N8N_ENCRYPTION_KEY를 고정해 모든 인스턴스에서 일치시킵니다.
시간대GENERIC_TIMEZONE과 컨테이너 시간대를 맞춰 예약 실행 오차를 막습니다.
업데이트새 이미지를 바로 운영에 올리지 않고 변경 내역과 복구 절차를 확인합니다.
queue mode로 여러 worker를 두는 경우 공식 문서는 Redis와 PostgreSQL 13 이상을 권장합니다. 모든 worker가 같은 암호화 키를 써야 자격증명을 읽을 수 있습니다. 파일시스템의 binary data 저장은 queue mode에서 지원되지 않으므로 외부 S3 저장소 같은 별도 구성이 필요할 수 있습니다.
볼륨 스냅샷 하나를 백업 완료로 보지 않습니다
복구하려면 데이터베이스, 암호화 키, 환경변수, 사용한 이미지 버전이 함께 있어야 합니다. DB만 복원하고 암호화 키를 잃으면 저장한 자격증명을 사용할 수 없습니다. 반대로 키만 있고 워크플로우 DB가 없으면 실행 이력과 설정을 되살릴 수 없습니다.
백업 파일은 있지만 새 서버에 어느 버전 이미지를 띄워야 하는지 기록이 없거나, 자동 백업이 같은 서버 디스크에만 있어 장애 때 함께 사라지는 경우입니다. 한 달에 한 번이라도 다른 위치에서 실제로 복원해 봐야 이런 구멍이 드러납니다.
Community Edition도 모든 협업 기능이 무료인 것은 아닙니다
Community Edition은 핵심 워크플로우 기능을 폭넓게 제공하지만 프로젝트, 워크플로우·자격증명 공유, SSO, Git 버전 관리, 외부 secrets, log streaming 같은 기능은 제공 범위가 다릅니다. 혼자 시작한 서버를 팀이 쓰게 될 때 권한 분리 요구가 생기면 라이선스와 플랜을 다시 확인해야 합니다.
또한 무료는 n8n 소프트웨어 요금에 대한 표현입니다. 클라우드 서버, DB, 객체 저장소, 메일 발송, 모니터링과 운영자의 시간은 별도입니다.
공식 문서가 먼저 거는 경고
Docker Compose 설치 문서는 명령어보다 앞에 전제 조건을 둡니다. 자체 호스팅에는 아래 기술 지식이 필요하다고 명시하고, 그다음 문장이 꽤 직설적입니다.“n8n은 숙련된 사용자에게만 자체 호스팅을 권장한다. 실수하면 데이터 손실, 보안 문제, 다운타임으로 이어질 수 있다. 서버 관리 경험이 없다면 n8n Cloud를 권한다.”
| 문서가 요구하는 지식 | 없으면 생기는 일 |
|---|---|
| 서버·컨테이너 설정과 구성 | 컨테이너가 죽은 뒤 복구가 안 됩니다 |
| 애플리케이션 리소스 관리와 스케일링 | 실행이 몰릴 때 큐가 밀리고 워크플로우가 유실됩니다 |
| 서버·애플리케이션 보안 | 웹훅 엔드포인트가 그대로 노출됩니다 |
| n8n 구성(환경 변수) | 암호화 키가 바뀌어 저장된 자격증명을 못 읽습니다 |
“무료니까 일단 올려 보자”와 “고객 업무를 여기에 맡기자” 사이의 거리가 이 표만큼입니다. 개인 학습이라면 얼마든지 시작해도 되지만, 남의 데이터가 지나가는 순간부터는 위 네 가지가 선택이 아니라 요구사항이 됩니다.
버전을 고정하지 않으면 매주 바뀝니다
같은 문서에 자주 놓치는 항목이 있습니다. n8n은 대부분의 주에 새 마이너 버전을 냅니다. 그리고 배포 채널이 둘로 나뉩니다.
| 채널 | 용도 | 2026년 9월 15일 확인 시점 |
|---|---|---|
| stable | 운영용 | 2.38.7 |
| beta | 최신 릴리스. 불안정할 수 있음 | 2.39.5 |
운영 인스턴스에서 이미지 태그를 latest로 두면 컨테이너를 다시 올릴 때마다 버전이 올라갑니다. 주 단위 릴리스라는 걸 감안하면, 어느 날 아침 워크플로우가 갑자기 다르게 동작하는 원인이 여기일 수 있습니다.운영에서는 태그를 특정 버전으로 고정하고, 올릴 때는 백업 후 의도적으로 올리는 편이 안전합니다.
설치 전에 준비해야 하는 것들
문서의 절차를 따라가 보면, 실제로 손이 가는 곳은 docker run한 줄이 아니라 그 주변입니다.
DNS온라인이나 네트워크에 공개하려면 전용 서브도메인을 만들고 서버 IP로 A 레코드를 겁니다. 이게 없으면 HTTPS도 웹훅도 정상 동작하지 않습니다.
.env 파일프로젝트 디렉터리를 만들고 인스턴스 정보를 담을 .env를 따로 둡니다. 설정을 compose 파일에 직접 박아 두면 나중에 공유나 백업이 곤란해집니다.
local-files 디렉터리n8n 인스턴스와 호스트가 파일을 주고받는 경로입니다. Compose가 자동 생성할 수도 있지만, 문서는 직접 만들라고 권합니다. 자동 생성되면 소유권과 권한이 의도와 다르게 잡힐 수 있기 때문입니다.
비루트 Docker 실행(선택)sudo 없이 Docker를 쓰려면 사용자에게 권한을 주고, 기존 세션에서는 exec sg docker newgrp을 실행해야 새 그룹 권한이 적용됩니다.
참고로 단일 컨테이너 설치를 다루던 기존 Docker 문서 상단에는 이제“이 내용은 오래되었습니다. 권장 설치 방법은 Docker Compose 문서를 참고하세요”라는 안내가 붙어 있습니다. 검색으로 옛 페이지에 먼저 닿았다면 Compose 쪽으로 옮겨 가는 편이 맞습니다.
월 서버비보다 복구 시간을 숫자로 넣습니다
가상 서버 월 15달러, 백업 5달러만 보면 월 20달러입니다. 여기에 업데이트·모니터링 2시간과 분기별 복구 연습 1시간을 월평균으로 환산해 더합니다. 운영시간의 가치를 시간당 3만 원으로 잡으면 인건비만 월 6만7,500원가량입니다. 이미 서버 운영 업무에 흡수할 수 있는 팀과 한 사람이 새로 배워야 하는 경우의 결론이 달라집니다.
처음 한 달은 로컬 Docker에서 비민감 워크플로우를 만들고, 백업에서 복구해본 뒤 외부 서버로 옮기는 순서가 안전합니다. 결제·삭제·고객 메시지처럼 되돌리기 어려운 작업은 실패 알림과 사람 승인이 갖춰지기 전까지 첫 운영 대상에서 빼두는 쪽이 마음 편합니다.
n8n 공식 Docker 설치, Community Edition 기능, queue mode 문서를 2026년 8월 28일 확인했습니다.