대상 독자#

이 가이드는 기존의 npm install n8n / npx n8n 방식을 대체하는 단일 명령으로 새 n8n 인스턴스를 설정합니다. 기존 방식은 n8n 3.0부터 더 이상 작동하지 않습니다. Docker를 사용해 본 적이 있든 없든, n8n을 실행하는 가장 빠른 방법입니다.

이 방법은 새로 설치하는 경우를 위한 것이며, 기존 설정을 변경하기 위한 것이 아닙니다.

• 이미 자체 Docker Compose 파일로 셀프 호스팅하고 있나요? 이 스크립트로 전환할 필요는 없지만, Docker Compose 설정 과정을 참고하셔도 좋습니다.
• 현재 npm으로 n8n을 설치하고 있나요? n8n 3.0부터 n8n은 Docker로만 배포됩니다. 기존 npm 설치는 당분간 계속 작동하지만, 새로 설치하는 경우(그리고 이후 업그레이드)에는 이 방법을 사용해야 합니다.

시작하기 전에 필요한 것#

이 방법은 Docker를 사용합니다. Docker는 다른 것을 직접 설치하거나 구성하지 않아도 되도록 n8n을 독립된 패키지로 실행하는 도구입니다. 아직 설치하지 않았다면 다음을 진행하세요.

• Docker를 설치합니다. 설정 명령에도 필요한 Docker Compose가 함께 포함되어 있습니다.

이 가이드를 사용하기 위해 Docker를 알아야 할 필요는 없습니다. 설치해서 백그라운드에서 실행 중이기만 하면 됩니다.

Docker 설치부터 n8n Assistant 켜기까지 이 설정을 다루는 동영상 가이드를 시청하세요.

명령 실행#

터미널을 열고 다음을 실행합니다.

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

이 명령은 다음 작업을 모두 수행합니다.

1. Docker가 설치되어 실행 중인지 확인하고, 그렇지 않으면 해결 방법을 알려줍니다.
2. 모든 것을 담을 n8n이라는 새 폴더를 현재 디렉터리에 만듭니다.
3. n8n 실행에 필요한 구성 파일을 작성합니다.
4. n8n을 다운로드하고 시작합니다.

여러 번 실행해도 안전합니다. 해당 폴더에 n8n이 이미 설정되어 있으면, 명령은 아무것도 변경하지 않고 이미 있다고 알려주기만 합니다.

성공적으로 실행되면 다음과 같이 표시됩니다.

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

✓ Docker found (24.0.6)
✓ Docker Compose found (v2.24.0)
✓ Created ./n8n/compose.yml
✓ Created ./n8n/searxng-settings.yml
✓ Created ./n8n/.env (unique secrets generated)
Pulling images and starting (this can take a few minutes on first run)...
✓ Started n8n 2.32.0 and sandbox services

n8n is running at: http://localhost:5678
Data stored in:    ./n8n (Docker volume: n8n-data)
Config files:      ./n8n/compose.yml, ./n8n/.env

To stop:      docker compose -f ./n8n/compose.yml down
To upgrade:   curl -fsSL https://get.n8n.io | sh -s -- --upgrade
To uninstall: docker compose -f ./n8n/compose.yml down -v   # -v DELETES all n8n data
              rm -rf ./n8n

기본으로 포함되는 구성 요소#

명령을 실행하면 아래의 모든 구성 요소가 자동으로 설정됩니다. 추가로 설치할 것은 없습니다.

팀이나 프로덕션 환경에 n8n을 설정하는 경우, 내장된 기본값보다 Postgres와 같이 더 견고한 데이터베이스를 사용하는 것을 고려하세요. 해당 설정은 Docker Compose를 사용하여 설치를 참조하세요.

샌드박스도 마찬가지입니다. 이 설정은 n8n 자체의 번들 샌드박스를 사용하며, 이는 시험해 보기에 적합합니다. 하지만 프로덕션에는 현재 n8n이 대신 Daytona를 권장합니다. 구성 방법은 n8n Assistant 설정을 참조하세요.

선택 사항: n8n Assistant 켜기#

n8n은 선택적 추가 기능인 n8n Assistant 없이도 완전하게 작동합니다. n8n이 실행되면, 가장 쉬운 방법은 인스턴스의 AI 설정 UI에서 켜는 것입니다. 거기에서 모델 API 키를 추가합니다. 로그인하기 전에 먼저 구성하고 싶다면 .env를 편집하세요.

1. 명령이 만든 .env 파일을 엽니다(기본적으로 ./n8n/.env에 있습니다).
2. N8N_INSTANCE_AI_MODEL_API_KEY 줄에 AI 공급자 키를 추가합니다.
3. n8n을 다시 시작합니다: docker compose -f ./n8n/compose.yml up -d

지원되는 공급자를 포함한 전체 설정 단계는 n8n Assistant 설정에 있습니다.

기본적으로 n8n Assistant의 웹 검색은 별도 설정이 필요 없는 번들 검색 도구를 통해 실행됩니다. Brave Search를 사용하려면 같은 .env 파일의 INSTANCE_AI_BRAVE_SEARCH_API_KEY에 Brave API 키를 추가하세요. 값이 설정되면 자동으로 사용됩니다.

일상 명령#

업그레이드로 변경되는 내용#

업그레이드 명령은 n8n과 번들 샌드박스 서비스를 모두 더 새로운 버전으로 이동합니다. .env의 두 줄인 N8N_VERSION과 N8N_SANDBOX_VERSION을 수정합니다. 데이터, 시크릿, 기타 설정은 그대로 유지됩니다.

샌드박스 버전이 .env로 옮겨지기 전에 설치했다면, compose.yml에 고정된 샌드박스 이미지 태그가 여전히 지정되어 있습니다. 첫 업그레이드에서는 해당 이미지 줄을 N8N_SANDBOX_VERSION을 사용하도록 다시 작성하고, 샌드박스 러너 주소(SANDBOX_RUNNER_HTTP_BASE_URL)를 http://에서 https://로 바꾸며, 이를 알리는 메모를 출력합니다. compose.yml의 다른 부분은 변경되지 않으므로 사용자가 수정한 내용은 그대로 유지됩니다.

플래그(더 세밀한 제어)#

설치 명령 끝에 다음을 추가하면 명령의 동작이 바뀝니다.

인터넷에서 받은 스크립트를 실행하고 싶지 않으신가요?#

먼저 다운로드하여 내용을 읽어 본 다음 직접 실행할 수 있습니다.

curl -fsSL https://get.n8n.io -o get-n8n.sh
less get-n8n.sh   # review it
sh get-n8n.sh

Windows 사용자#

원라인 설정 명령은 셸 스크립트를 이해하는 터미널이 필요하며, 표준 Windows 명령 프롬프트나 PowerShell은 이에 해당하지 않습니다. 대신 다음에서 실행하세요.

• Docker Desktop의 WSL2 통합을 켠 WSL(Windows Subsystem for Linux).
• Docker Desktop이 실행 중인 상태의 Git Bash(Git for Windows와 함께 설치됨)도 POSIX 셸 스크립트를 실행할 수 있지만, n8n은 원라인 설정 명령에 대해 이를 처음부터 끝까지 검증하지 않았습니다. Git Bash가 사용자의 환경에서 작동하는 것을 확인하지 않았다면 WSL을 사용하세요.

관련 리소스#

• 설치 옵션
• Docker Compose를 사용하여 설치
• npm으로 설치
• Docker로 설치
• 클라우드 공급자 사용