n8n을 Docker Compose로 띄우기 — 실전 입문

💡 N8N_ENCRYPTION_KEY는 n8n이 저장하는 모든 크리덴셜(Google, Slack 등 인증 정보)을 암호화하는 데 사용됩니다. 이 키를 잃어버리거나 변경하면 기존 크리덴셜을 복호화할 수 없어서 모든 연동을 다시 설정해야 합니다.

💡 n8n에서 PostgreSQL을 사용하려면 DB_TYPE=postgresdb 로 설정해야 합니다. 주의할 점은 postgres가 아니라 postgresdb 입니다. 이 설정과 함께 DB_POSTGRESDB_HOST, DB_POSTGRESDB_DATABASE 등의 환경변수도 함께 설정해야 합니다.

💡 단순히 depends_on에 서비스 이름만 나열하면 컨테이너가 시작되는 시점만 체크합니다. PostgreSQL이 실제로 접속 가능한 상태인지 확인하려면 healthcheck를 설정하고 condition: service_healthy를 사용해야 합니다. 그렇지 않으면 n8n이 DB 준비 전에 먼저 시작되어 연결 오류가 발생합니다.

💡 WEBHOOK_URL은 외부 서비스들이 n8n의 Webhook 노드를 트리거할 때 사용하는 공개 URL입니다. 예를 들어 GitHub이 코드 푸시 이벤트를 n8n에 전달할 때 이 URL로 요청합니다. Nginx 뒤에 n8n이 있는 경우, n8n 내부 포트가 아닌 실제 외부에서 접근 가능한 HTTPS URL을 설정해야 합니다.

💡 EXECUTIONS_DATA_PRUNE=true로 자동 정리를 활성화하고, EXECUTIONS_DATA_MAX_AGE로 보관 기간(시간 단위)을 설정합니다. 336시간은 14일입니다. 실행 이력은 계속 쌓이면 DB 용량을 과도하게 차지하므로 반드시 정리 설정을 해두어야 합니다. 성공한 실행은 EXECUTIONS_DATA_SAVE_ON_SUCCESS=none으로 저장 자체를 막는 것도 좋은 방법입니다.