실행(execution) 설정과 실행량에 따라 n8n 데이터베이스의 크기가 커져서 저장 공간이 부족해질 수 있습니다.

이를 방지하려면, n8n은 불필요한 데이터를 저장하지 말고 오래된 실행 데이터의 정리(pruning)를 활성화할 것을 권장합니다.

이를 위해 해당 환경 변수를 구성하세요.

저장 데이터 줄이기#

n8n이 저장할 실행 데이터를 선택할 수 있습니다. 예를 들어, Error로 종료된 실행만 저장할 수 있습니다.

# npm
# Save executions ending in errors
export EXECUTIONS_DATA_SAVE_ON_ERROR=all

# Don't save successful executions
export EXECUTIONS_DATA_SAVE_ON_SUCCESS=none

# Don't save node progress for each execution
export EXECUTIONS_DATA_SAVE_ON_PROGRESS=false

# Don't save manually launched executions
export EXECUTIONS_DATA_SAVE_MANUAL_EXECUTIONS=false

# Docker
docker run -it --rm \
 --name n8n \
 -p 5678:5678 \
 -e EXECUTIONS_DATA_SAVE_ON_ERROR=all \
 -e EXECUTIONS_DATA_SAVE_ON_SUCCESS=none \
 -e EXECUTIONS_DATA_SAVE_ON_PROGRESS=true \
 -e EXECUTIONS_DATA_SAVE_MANUAL_EXECUTIONS=false \
 docker.n8n.io/n8nio/n8n

# Docker Compose
n8n:
    environment:
      - EXECUTIONS_DATA_SAVE_ON_ERROR=all
      - EXECUTIONS_DATA_SAVE_ON_SUCCESS=none
      - EXECUTIONS_DATA_SAVE_ON_PROGRESS=true
      - EXECUTIONS_DATA_SAVE_MANUAL_EXECUTIONS=false

실행 정리 활성화#

실행 정리(executions pruning)는 완료된 실행을 해당 실행 데이터 및 바이너리 데이터와 함께 정기적인 일정에 따라 삭제합니다. n8n은 기본적으로 정리를 활성화합니다. 성능상의 이유로, 정리는 먼저 삭제 대상으로 표시한 뒤 나중에 영구적으로 제거합니다.

n8n은 다음 조건 중 하나라도 발생하면 실행을 정리합니다.

• 연령(Age): 실행이 완료된 지 EXECUTIONS_DATA_MAX_AGE 시간(기본값: 336시간 -> 14일)이 지난 경우.
• 개수(Count): 전체 실행 수가 EXECUTIONS_DATA_PRUNE_MAX_COUNT(기본값: 10,000)를 초과하는 경우. 이 경우 n8n은 오래된 것부터 최신 순으로 실행을 삭제합니다.

다음 사항을 유의하세요.

• new, running, waiting 상태의 실행은 정리 대상이 아닙니다.
• 주석이 달린 실행(예: 태그나 평점이 있는 실행)은 절대 정리되지 않습니다.
• 정리는 EXECUTIONS_DATA_HARD_DELETE_BUFFER 시간(기본값: 1시간)의 안전 버퍼 기간을 준수하여, 사용자가 워크플로를 빌드하거나 디버깅하는 동안 최근 데이터를 계속 사용할 수 있도록 합니다.

# Enable executions pruning
export EXECUTIONS_DATA_PRUNE=true

# How old (hours) a finished execution must be to qualify for soft-deletion
export EXECUTIONS_DATA_MAX_AGE=168

# Max number of finished executions to keep. May not strictly prune back down to the exact max count. Set to `0` for unlimited.
export EXECUTIONS_DATA_PRUNE_MAX_COUNT=50000

# Docker
docker run -it --rm \
 --name n8n \
 -p 5678:5678 \
 -e EXECUTIONS_DATA_PRUNE=true \
 -e EXECUTIONS_DATA_MAX_AGE=168 \
 docker.n8n.io/n8nio/n8n

# Docker Compose
n8n:
    environment:
      - EXECUTIONS_DATA_PRUNE=true
      - EXECUTIONS_DATA_MAX_AGE=168
      - EXECUTIONS_DATA_PRUNE_MAX_COUNT=50000