n8n 설치 가이드 – 자가 호스팅(Docker) 편

💻 n8n 설치 가이드 – 자가 호스팅(Docker) 편

n8n은 오픈소스 자동화 플랫폼으로, 직접 서버에 설치해서 무료로 사용할 수 있습니다.
이 포스팅에서는 가장 쉽고 많이 쓰이는 Docker 방식 설치 방법을 소개합니다.

---

🧩 설치 전 준비사항

• Ubuntu 20.04 이상 서버 (AWS, DigitalOcean, Oracle Cloud 등 가능)
• 포트 5678번 개방
• 도메인은 선택사항 (추후 HTTPS 적용 시 유리)

---

⚙️ 1. Docker & Docker Compose 설치

sudo apt update
sudo apt install -y docker.io docker-compose
sudo usermod -aG docker $USER

※ 위 명령어는 Ubuntu 기준입니다. 설치 후 재부팅 또는 로그아웃/로그인 필요

---

🚀 2. n8n 실행 (테스트용)

아래 명령어를 입력하면 n8n이 바로 실행됩니다.

docker run -it --rm \
  -p 5678:5678 \
  -v ~/.n8n:/home/node/.n8n \
  n8nio/n8n

브라우저에서 http://[서버IP]:5678로 접속해 확인할 수 있습니다.

---

📦 3. 백그라운드 실행 (docker-compose)

docker-compose.yml 파일을 작성합니다:

version: '3'
services:
  n8n:
    image: n8nio/n8n
    restart: always
    ports:
      - "5678:5678"
    volumes:
      - ~/.n8n:/home/node/.n8n
    environment:
      - N8N_BASIC_AUTH_ACTIVE=true
      - N8N_BASIC_AUTH_USER=admin
      - N8N_BASIC_AUTH_PASSWORD=yourpassword

실행:

docker-compose up -d

http://[서버IP]:5678 접속 후 admin / yourpassword로 로그인합니다.

---

🔐 4. HTTPS & 도메인 설정 (선택사항)

도메인 연결 후 NGINX + Let's Encrypt 조합으로 SSL 인증서를 적용할 수 있습니다. 필요 시 N8N_HOST, WEBHOOK_URL 환경변수 설정도 고려해야 합니다.

---

📎 참고 링크

• n8n 공식 문서: https://docs.n8n.io
• GitHub: https://github.com/n8n-io/n8n

설치가 완료되었으면, 이제 본격적인 자동화 워크플로우 실습을 시작할 수 있습니다. 👉 다음 글에서는 Webhook + Slack 자동화 워크플로우 만들기를 다뤄보겠습니다!