n8n 셀프호스팅 설치, 도커 한 줄 명령으로 첫 워크플로까지

 

도커만 준비돼 있으면 명령 한 줄로 n8n을 띄우고 첫 자동화를 돌려볼 수 있다. 설치부터 외부 공개 전 점검까지의 순서를 정리한다.

 

자동화 도구를 알아보면 실행 횟수 제한과 데이터 보관 위치에서 먼저 막힌다. n8n 셀프호스팅은 내 서버에 n8n을 직접 올려 그 제약 없이 워크플로를 돌리는 방식이다.

 

이 글은 준비물 확인, 한 줄 설치, 첫 워크플로 실행, 데이터 보관, 보안 점검까지를 순서대로 다루어 보겠다. 공식 문서에 표시된 안정 버전은 2.39.7이다.

 

 

 

셀프호스팅이 맞는 경우

 

핵심 요약 │ 서버 운영을 감당할 수 있을 때만 셀프호스팅이 이득이다.

 

 

n8n은 클라우드와 셀프호스팅 두 가지로 쓸 수 있고, 어느 쪽이든 제품 자체는 같다. 공식 문서는 셀프호스팅에 서버와 컨테이너 구성, 자원 관리, 보안 설정 지식이 필요하다고 적고 있다.

 

설정을 잘못하면 데이터 손실이나 보안 문제로 이어질 수 있어, 서버 운영 경험이 없다면 클라우드를 권한다.

 

그 전에 무엇부터 자동화할지 고르는 기준은 회수 시간 계산 글에 정리해 두었다.

 

n8n 공식 문서는 셀프호스팅을 숙련 사용자에게 권장한다고 명시한다.

반대로 사내 데이터를 외부 서비스에 두기 어렵거나, 실행 횟수 단위 과금을 피하고 싶다면 셀프호스팅이 맞는다.

 

판단 기준은 기능 차이가 아니라 운영 부담을 누가 질 것인가다.

 

 

무료 범위와 라이선스

 

핵심 요약 │ 라이선스 키 없이 실행하면 무료 커뮤니티 에디션으로 동작한다.

 

 

셀프호스팅 설치는 모두 같은 제품을 쓰고, 라이선스 키가 없으면 무료 커뮤니티 에디션이 된다. 이메일을 등록하면 폴더 정리, 에디터 내 디버그, 사용자 지정 실행 데이터가 추가로 열린다. 등록 역시 무료다.

 

워크플로와 자격증명 공유처럼 여러 명이 함께 쓰는 기능은 유료 플랜에 들어 있다.

 

라이선스는 오픈소스가 아니라 Sustainable Use License다. 소스는 공개돼 있고 자유롭게 실행·수정할 수 있지만, n8n 자체를 상품으로 만들어 남에게 파는 용도는 제한된다.

 

개인이나 자기 회사 업무에 쓰는 범위라면 걸릴 일이 없다.

 

세 도구의 과금 단위가 어떻게 다른지는 요금 계산법을 정리한 글에서 따로 다뤘다.

 

 

설치 전 준비물

 

핵심 요약 │ 도커와 compose v2 플러그인만 있으면 준비가 끝난다.

 

 

설치 방법은 한 줄 설치, 도커 컴포즈, npm 세 가지였다. 다만 공식 문서는 n8n 3.0부터 도커로만 배포한다고 안내한다. 3.0은 2026년 10월 출시 예정이며, 기존 npm 설치는 당분간 동작하지만 새로 시작한다면 도커 기준으로 준비하는 편이 맞는다.

 

설정 경로 │ 도커 설치 → 도커 실행 상태 확인 → 터미널 열기

 

한 줄 설치 명령은 docker compose v2 플러그인을 요구한다. 예전 docker-compose 단독 실행 파일만 있으면 동작하지 않는다.

 

윈도우에서는 명령 프롬프트나 파워셸 대신 WSL에서 실행한다. 서버 사양은 공식 권장치가 공개돼 있지 않아, 민간 가이드가 드는 최소 2GB 메모리, 연동이 많다면 4GB 이상을 참고치로 잡는다.

 

 

 

한 줄 명령으로 설치하기

 

핵심 요약 │ 명령 한 줄이 설정 파일 작성과 실행까지 대신한다.

 

curl -fsSL https://get.n8n.io | sh

 

이 명령은 도커가 설치돼 실행 중인지 확인하고, 현재 위치에 n8n 폴더를 만든 뒤 compose.yml과 .env를 작성하고 이미지를 받아 실행한다.

여러 번 실행해도 안전하다. 이미 설정된 폴더가 있으면 그대로 두고 알려 준다.

 

기본 데이터베이스는 파일 형태의 SQLite라 별도 설치가 필요 없다.

 

실행이 끝나면 http://localhost:5678 로 접속해 관리자 계정을 만든다. 첫 실행은 준비에 시간이 걸리므로 화면이 바로 열리지 않으면 잠시 기다린 뒤 새로 고친다.

 

인터넷에서 받은 스크립트를 바로 실행하기 꺼려진다면 파일로 내려받아 내용을 확인한 다음 실행해도 된다. 여러 명이 쓰거나 운영 환경이라면 기본 SQLite 대신 Postgres 구성을 쓰라고 공식 문서가 안내한다.

 

 

첫 워크플로 만들기

 

핵심 요약 │ 트리거 노드를 먼저 놓고 수동 실행으로 결과를 확인한다.

 

 

워크플로는 수동 실행과 트리거 실행 두 가지로 돌아간다. 공식 튜토리얼은 스케줄 트리거로 시작한다. 새 워크플로를 만들고 첫 단계 추가에서 Schedule을 검색해 Schedule Trigger를 캔버스에 놓는다.

 

실행 간격을 주 단위로 두고 요일과 시각을 지정하는 식이다.

 

다음 노드는 트리거 오른쪽 연결점에서 추가한다. 외부 서비스를 붙이면 자격증명 입력을 요구하는데, 이 값은 워크플로 밖으로 노출하지 않도록 주의한다.

 

만드는 중에는 Execute Workflow로 수동 실행해 노드마다 어떤 데이터가 나오는지 확인한다. 저장과 활성화는 다르다. 정해진 시각에 실제로 도는 것은 워크플로를 활성화한 뒤부터다.

 

기본 흐름이 익숙해지면 AI 노드로 메일을 분류하는 워크플로처럼 실제 업무에 붙여 본다.

 

 

 

데이터 보관과 업그레이드

 

핵심 요약 │ .n8n 폴더와 암호화 키가 사라지면 자격증명도 쓸 수 없다.

 

 

n8n은 컨테이너 안 /home/node/.n8n 경로에 설정과 암호화 키를 둔다. 도커 이미지 문서는 다른 데이터베이스를 쓰더라도 이 폴더는 반드시 유지하라고 경고한다. 저장된 자격증명을 푸는 열쇠가 여기 들어 있기 때문이다.

 

암호화 키를 잃어버리면 저장해 둔 자격증명을 다시 사용할 수없다.

업그레이드와 중지 명령은 아래와 같다. 삭제 명령에 -v를 붙이면 데이터까지 함께 지워지므로 백업 전에는 쓰지 않는다.

 

curl -fsSL https://get.n8n.io | sh -s -- --upgrade
docker compose -f ./n8n/compose.yml down

 

n8n은 대체로 매주 새 마이너 버전을 낸다. 업데이트가 잦은 만큼, 실제 업무를 맡긴 인스턴스라면 버전을 지정해 받아 두고 확인한 뒤 올리는 편이 안전하다.

 

 

 

외부 공개 전 보안 점검

 

핵심 요약 │ 도메인과 HTTPS를 갖춘 뒤에 외부로 열어야 한다.

 

 

혼자 로컬에서 쓰는 동안은 5678 포트로 충분하다. 외부 서비스의 웹훅을 받으려면 인터넷에서 닿아야 하고, 이때부터 점검할 항목이 늘어난다.

 

공식 보안 문서는 리버스 프록시로 TLS를 처리하고, 보안 감사를 실행하며, 커뮤니티 노드 설치 위험을 인지하고, 코드 노드에서 외부 모듈을 불러오지 못하게 막고, 명령 실행이나 SSH 같은 노드를 제외하는 방법을 권한다.

 

민간 운영 가이드는 여기에 더해 5678 포트를 직접 열지 말고 80·443만 열어 프록시 뒤에 두라고 정리한다. HTTP로 접속하면 보안 쿠키 경고가 뜨는데, 쿠키 설정을 꺼서 넘기는 대신 도메인과 HTTPS를 붙이는 쪽이 맞는 해결이다. 주소 관련 환경 변수는 실제 도메인에 맞춰 둔다.

 

 

주요 환경 변수 │ N8N_HOST, N8N_PROTOCOL, WEBHOOK_URL, N8N_ENCRYPTION_KEY

 

 

마치는 글과 실행 순서

 

찾아보면서 가장 의외였던 건 npn 설치 방식이 곧 막힌다는 점이었다. 오래된 설치 글을 그대로 따라 하면 시작부터 어긋난다.

 

먼저 처리해 둘 일부터 적어 본다.

 

• 도커를 설치하고 실행 상태를 확인한 뒤 한 줄 명령으로 로컬에 올린다.
• 관리자 계정을 만들고 .n8n 폴더와 암호화 키의 백업 위치를 정해 둔다.
• 외부 공개는 도메인과 HTTPS를 준비한 다음으로 미룬다.

 

함께 읽을 글

• 칼퇴를 부르는 업무 자동화 Make vs Zapier 비교 및 스마트한 사용법
• n8n 셀프호스팅 설치, 도커 한 줄 명령으로 첫 워크플로까지
• 구글 폼 응답 자동 분기: 노션·슬랙·시트로 한 번에 보내기

 

설치하시다가 막힌 단계가 있다면 댓글로 남겨 주세요.

 

검증 출처

• n8n 공식 문서 – 한 줄 설치
• n8n 공식 문서 – 도커 설치
• n8n 공식 문서 – 도커 컴포즈 설치
• n8n 공식 문서 – 셀프호스팅 개요
• n8n 공식 문서 – 에디션 비교
• n8n 공식 문서 – 사용 방식 선택
• n8n 공식 문서 – 첫 워크플로 만들기
• n8n 공식 문서 – 빠른 시작
• n8n 공식 문서 – 보안 권고 사항
• n8n 공식 문서 – SSL 설정
• n8n 공식 문서 – 배포 환경 변수
• Docker Hub – n8nio/n8n 이미지 문서
• Docker 공식 – 설치 안내
• GitHub – n8n Postgres 컴포즈 예제
• Sliplane – 셀프호스팅 운영 점검 항목