본문 바로가기
카테고리 없음

도커(Docker)로 n8n 설치하기: 단계별 가이드

by bloghi 2025. 2. 18.

n8n은 다양한 앱을 자동화할 수 있는 오픈소스 워크플로우 자동화 툴입니다. 이번 글에서는 도커(Docker)를 사용하여 n8n을 셀프호스팅 환경에 설치하는 방법을 단계별로 소개합니다. 도커는 설치가 간편하고 환경에 관계없이 일관된 실행 환경을 제공하므로, 자동화 시스템을 구축하려는 분들께 매우 유용한 도구입니다.

도커와 도커 컴포즈 설치하기

n8n 도커 설치를 위해서는 먼저 도커(Docker)와 도커 컴포즈(Docker Compose)를 설치해야 합니다. 이 두 도구는 컨테이너 기반 앱 실행 및 관리를 위한 핵심 툴입니다.

Ubuntu에서 도커 설치

sudo apt update
sudo apt install docker.io

도커 설치 후 아래 명령어로 설치 여부를 확인합니다:

docker --version

도커 컴포즈 설치

이제 도커 컴포즈를 설치합니다:

sudo apt install docker-compose

설치 확인:

docker-compose --version

n8n 도커 이미지 다운로드

이제 n8n 공식 도커 이미지를 Docker Hub에서 다운로드합니다. 최신 버전으로 설치할 수 있습니다.

docker pull n8nio/n8n

n8n 컨테이너 실행

도커 이미지 다운로드가 완료되었으면 n8n 컨테이너를 실행합니다:

docker run -d --name n8n -p 5678:5678 n8nio/n8n

위 명령어 설명:

  • -d: 백그라운드 실행
  • --name n8n: 컨테이너 이름 지정
  • -p 5678:5678: 포트 매핑

실행 후 브라우저에서 http://서버IP:5678 주소로 접속하여 n8n을 확인할 수 있습니다.

환경 변수로 n8n 설정하기

도커 명령어에 환경 변수를 추가하여 데이터베이스, 이메일 등 다양한 설정을 커스터마이징할 수 있습니다.

docker run -d --name n8n -p 5678:5678 \
-e DB_TYPE=postgresdb \
-e DB_POSTGRESDB_HOST=your-db-host \
-e DB_POSTGRESDB_PORT=5432 \
-e DB_POSTGRESDB_USER=your-user \
-e DB_POSTGRESDB_PASSWORD=your-password \
n8nio/n8n

이 설정을 통해 외부 PostgreSQL 데이터베이스와 연동된 n8n 인스턴스를 실행할 수 있습니다.

도커 컴포즈(docker-compose)로 n8n 실행하기

여러 설정을 파일로 관리하고 싶다면 docker-compose.yml 파일을 사용하는 것이 효과적입니다.

version: '3'
services:
  n8n:
    image: n8nio/n8n
    environment:
      - DB_TYPE=postgresdb
      - DB_POSTGRESDB_HOST=your-db-host
      - DB_POSTGRESDB_USER=your-user
      - DB_POSTGRESDB_PASSWORD=your-password
    ports:
      - "5678:5678"
    volumes:
      - ~/.n8n:/root/.n8n

위 파일을 저장한 후, 다음 명령어로 컨테이너를 실행합니다:

docker-compose up -d

이 명령어는 설정된 모든 서비스를 백그라운드에서 실행하며, 변경이 필요할 경우 yml 파일만 수정하면 됩니다.

마무리

이번 가이드를 통해 도커를 활용한 n8n 설치 방법을 익히셨다면, 이제 여러분의 서버에서 직접 워크플로우 자동화를 시작할 수 있습니다. 도커 기반 설치는 유지보수가 쉬우며, 다양한 환경에서 안정적인 실행을 보장합니다.

다음 강의에서는 n8n에서 기본적인 워크플로우 생성 방법과 자동화 시나리오 구성을 다룰 예정입니다. n8n 자동화의 세계로 본격적인 첫발을 내디뎌보세요!

티스토리툴바