실행 환경 변수

요약

개별 변수에 _FILE을 추가하여 별도의 파일에서 구성을 제공할 수 있습니다. 이 페이지에서는 워크플로 실행 설정을 구성하기 위한 환경 변수를 나열합니다.

파일 기반 구성

개별 변수에 _FILE을 추가하여 별도의 파일에서 구성을 제공할 수 있습니다. 자세한 내용은 별도 파일에 민감한 데이터 보관하기를 참고하세요.

이 페이지에서는 워크플로 실행 설정을 구성하기 위한 환경 변수를 나열합니다.

변수	타입	기본값	설명
`EXECUTIONS_MODE`	Enum string: `regular`, `queue`	`regular`	실행이 직접 실행될지 큐를 사용할지 여부입니다. 자세한 내용은 큐 모드를 참조하세요.
`EXECUTIONS_TIMEOUT`	Number	`-1`	모든 워크플로에 대한 기본 타임아웃(초)을 설정합니다. 이 시간이 지나면 n8n이 실행을 중단합니다. 사용자는 `EXECUTIONS_TIMEOUT_MAX`에 설정된 시간까지 개별 워크플로에 대해 이 값을 재정의할 수 있습니다. 비활성화하려면 `EXECUTIONS_TIMEOUT`을 `-1`로 설정합니다.
`EXECUTIONS_TIMEOUT_MAX`	Number	`3600`	사용자가 개별 워크플로에 설정할 수 있는 최대 실행 시간(초)입니다.
`N8N_AI_TIMEOUT_MAX`	Number	`3600000`	AI 및 LLM 노드(OpenAI, Anthropic, Mistral, Ollama 등)의 HTTP 요청 타임아웃(밀리초)을 설정합니다. n8n이 타임아웃 전에 AI 서비스의 응답을 기다리는 시간을 제어합니다. 응답이 느린 로컬 AI 서비스나 더 긴 처리 시간이 필요한 복잡한 프롬프트에 유용합니다.
`EXECUTIONS_DATA_SAVE_ON_ERROR`	Enum string: `all`, `none`	`all`	오류 발생 시 n8n이 실행 데이터를 저장할지 여부입니다.
`EXECUTIONS_DATA_SAVE_ON_SUCCESS`	Enum string: `all`, `none`	`all`	성공 시 n8n이 실행 데이터를 저장할지 여부입니다.
`EXECUTIONS_DATA_SAVE_ON_PROGRESS`	Boolean	`false`	각 노드 실행 시 진행 상황을 저장할지(true) 여부(false)입니다.
`EXECUTIONS_DATA_SAVE_MANUAL_EXECUTIONS`	Boolean	`true`	수동으로 시작된 실행의 데이터를 저장할지 여부입니다.
`EXECUTIONS_DATA_PRUNE`	Boolean	`true`	이전 실행 데이터를 순환 기준으로 삭제할지 여부입니다.
`EXECUTIONS_DATA_MAX_AGE`	Number	`336`	실행이 삭제되기 전까지의 최대 경과 시간(시간)입니다.
`EXECUTIONS_DATA_PRUNE_MAX_COUNT`	Number	`10000`	데이터베이스에 유지할 최대 실행 수입니다. 0 = 제한 없음
`EXECUTIONS_DATA_HARD_DELETE_BUFFER`	Number	`1`	완료된 실행 데이터가 하드 삭제되기까지 필요한 최소 경과 시간(시간)입니다. 기본적으로 이 버퍼는 워크플로 작성 중에 사용자가 필요할 수 있는 최근 실행을 제외합니다.
`EXECUTIONS_DATA_PRUNE_HARD_DELETE_INTERVAL`	Number	`15`	실행 데이터가 하드 삭제되는 빈도(분)입니다.
`EXECUTIONS_DATA_PRUNE_SOFT_DELETE_INTERVAL`	Number	`60`	실행 데이터가 소프트 삭제되는 빈도(분)입니다.
`N8N_CONCURRENCY_PRODUCTION_LIMIT`	Number	`-1`	일반 모드와 스케일링 모드 모두에서 동시에 허용되는 최대 프로덕션 실행 수입니다. 일반 모드에서 비활성화하려면 `-1`로 설정합니다.
`N8N_WORKFLOW_AUTODEACTIVATION_ENABLED`	Boolean	`false`	반복된 충돌 실행 후 워크플로를 자동으로 비공개로 전환할지 여부입니다.
`N8N_WORKFLOW_AUTODEACTIVATION_MAX_LAST_EXECUTIONS`	Number	`3`	워크플로를 비공개로 전환하기 전 충돌 실행 횟수입니다.

실행 환경 변수

원문 보기

번역일: 2026-03-12

요약

파일 기반 구성

개별 변수에 _FILE을 추가하여 별도의 파일에서 구성을 제공할 수 있습니다. 자세한 내용은 별도 파일에 민감한 데이터 보관하기를 참고하세요.

이 페이지에서는 워크플로 실행 설정을 구성하기 위한 환경 변수를 나열합니다.

변수	타입	기본값	설명
`EXECUTIONS_MODE`	Enum string: `regular`, `queue`	`regular`	실행이 직접 실행될지 큐를 사용할지 여부입니다. 자세한 내용은 큐 모드를 참조하세요.
`EXECUTIONS_TIMEOUT`	Number	`-1`	모든 워크플로에 대한 기본 타임아웃(초)을 설정합니다. 이 시간이 지나면 n8n이 실행을 중단합니다. 사용자는 `EXECUTIONS_TIMEOUT_MAX`에 설정된 시간까지 개별 워크플로에 대해 이 값을 재정의할 수 있습니다. 비활성화하려면 `EXECUTIONS_TIMEOUT`을 `-1`로 설정합니다.
`EXECUTIONS_TIMEOUT_MAX`	Number	`3600`	사용자가 개별 워크플로에 설정할 수 있는 최대 실행 시간(초)입니다.
`N8N_AI_TIMEOUT_MAX`	Number	`3600000`	AI 및 LLM 노드(OpenAI, Anthropic, Mistral, Ollama 등)의 HTTP 요청 타임아웃(밀리초)을 설정합니다. n8n이 타임아웃 전에 AI 서비스의 응답을 기다리는 시간을 제어합니다. 응답이 느린 로컬 AI 서비스나 더 긴 처리 시간이 필요한 복잡한 프롬프트에 유용합니다.
`EXECUTIONS_DATA_SAVE_ON_ERROR`	Enum string: `all`, `none`	`all`	오류 발생 시 n8n이 실행 데이터를 저장할지 여부입니다.
`EXECUTIONS_DATA_SAVE_ON_SUCCESS`	Enum string: `all`, `none`	`all`	성공 시 n8n이 실행 데이터를 저장할지 여부입니다.
`EXECUTIONS_DATA_SAVE_ON_PROGRESS`	Boolean	`false`	각 노드 실행 시 진행 상황을 저장할지(true) 여부(false)입니다.
`EXECUTIONS_DATA_SAVE_MANUAL_EXECUTIONS`	Boolean	`true`	수동으로 시작된 실행의 데이터를 저장할지 여부입니다.
`EXECUTIONS_DATA_PRUNE`	Boolean	`true`	이전 실행 데이터를 순환 기준으로 삭제할지 여부입니다.
`EXECUTIONS_DATA_MAX_AGE`	Number	`336`	실행이 삭제되기 전까지의 최대 경과 시간(시간)입니다.
`EXECUTIONS_DATA_PRUNE_MAX_COUNT`	Number	`10000`	데이터베이스에 유지할 최대 실행 수입니다. 0 = 제한 없음
`EXECUTIONS_DATA_HARD_DELETE_BUFFER`	Number	`1`	완료된 실행 데이터가 하드 삭제되기까지 필요한 최소 경과 시간(시간)입니다. 기본적으로 이 버퍼는 워크플로 작성 중에 사용자가 필요할 수 있는 최근 실행을 제외합니다.
`EXECUTIONS_DATA_PRUNE_HARD_DELETE_INTERVAL`	Number	`15`	실행 데이터가 하드 삭제되는 빈도(분)입니다.
`EXECUTIONS_DATA_PRUNE_SOFT_DELETE_INTERVAL`	Number	`60`	실행 데이터가 소프트 삭제되는 빈도(분)입니다.
`N8N_CONCURRENCY_PRODUCTION_LIMIT`	Number	`-1`	일반 모드와 스케일링 모드 모두에서 동시에 허용되는 최대 프로덕션 실행 수입니다. 일반 모드에서 비활성화하려면 `-1`로 설정합니다.
`N8N_WORKFLOW_AUTODEACTIVATION_ENABLED`	Boolean	`false`	반복된 충돌 실행 후 워크플로를 자동으로 비공개로 전환할지 여부입니다.
`N8N_WORKFLOW_AUTODEACTIVATION_MAX_LAST_EXECUTIONS`	Number	`3`	워크플로를 비공개로 전환하기 전 충돌 실행 횟수입니다.