기본적으로 n8n은 자격 증명, 과거 실행 내역, 워크플로를 저장하는 데 SQLite를 사용합니다. n8n은 PostgresDB도 지원합니다. n8n의 PostgreSQL 버전 정책은 지원되는 PostgreSQL 버전을 참고하세요.

n8n 설치 방식별 데이터베이스 유형#

사용되는 데이터베이스 유형은 n8n 설치 방식에 따라 다릅니다.

셀프 호스팅 n8n#

기본적으로 셀프 호스팅 설치 환경은 SQLite를 사용합니다. 필요한 경우 적절한 환경 변수를 설정하여 PostgreSQL을 구성할 수 있습니다(PostgresDB 구성 참고).

n8n Cloud#

n8n Cloud 설치는 플랜 등급에 따라 서로 다른 데이터베이스를 사용합니다.

• SQLite: Starter, Pro 플랜, 그리고 레거시 Enterprise 플랜
• PostgreSQL: Enterprise Scaling 플랜에서만 사용

공유 설정#

다음 환경 변수는 모든 데이터베이스에서 공통으로 사용됩니다.

• DB_TABLE_PREFIX (기본값: -) - 테이블 이름에 붙는 접두사

PostgresDB#

지원되는 PostgreSQL 버전#

n8n은 다음을 지원합니다:

• 현재 유지 관리 중인 최신 PostgreSQL 메이저 버전 두 개(2026년 7월 기준 17과 18).
• 호환성을 위한 추가 메이저 버전 하나(16).

사용 중인 메이저 버전 내에서 최신 마이너 릴리즈를 실행하세요.

Amazon Aurora PostgreSQL은 실험적 지원입니다. n8n의 호스팅 템플릿은 고가용성 구성을 위해 Aurora를 제공하며, 기본 데이터베이스에 장애가 발생했을 때 Aurora가 더 빠르게 복구됩니다. n8n은 Aurora를 테스트하거나 인증하지 않으며, n8n의 PostgreSQL 버전 지원 범위는 Aurora에 적용되지 않습니다. Aurora가 제공하는 기능이 꼭 필요한 경우가 아니라면 업스트림 PostgreSQL을 사용하세요.

n8n은 AlloyDB, CockroachDB, YugabyteDB 같은 다른 PostgreSQL 호환 파생 제품을 지원하지 않습니다.

PostgreSQL 프로젝트는 매년 11월에 유지 관리 대상 중 가장 오래된 메이저 버전을 종료하고 새 메이저 버전을 릴리즈하므로, n8n이 지원하는 버전 범위는 해마다 바뀝니다. 다른 곳에서 본 특정 버전 번호에 의존하지 말고 이 페이지에서 현재 지원되는 버전을 확인하세요.

PostgresDB를 데이터베이스로 사용하려면 다음 환경 변수를 지정할 수 있습니다.

• DB_TYPE=postgresdb
• DB_POSTGRESDB_DATABASE (기본값: 'n8n')
• DB_POSTGRESDB_HOST (기본값: 'localhost')
• DB_POSTGRESDB_PORT (기본값: 5432)
• DB_POSTGRESDB_USER (기본값: 'postgres')
• DB_POSTGRESDB_PASSWORD (기본값: 비어 있음)
• DB_POSTGRESDB_SCHEMA (기본값: 'public')
• DB_POSTGRESDB_SSL_CA (기본값: undefined): 연결을 검증하는 데 사용되는 서버의 CA 인증서 경로(기회적 암호화(opportunistic encryption)는 지원되지 않음)
• DB_POSTGRESDB_SSL_CERT (기본값: undefined): 클라이언트 TLS 인증서 경로
• DB_POSTGRESDB_SSL_KEY (기본값: undefined): 인증서에 대응하는 클라이언트 개인 키 경로
• DB_POSTGRESDB_SSL_REJECT_UNAUTHORIZED (기본값: true): 검증에 실패한 TLS 연결을 거부할지 여부

export DB_TYPE=postgresdb
export DB_POSTGRESDB_DATABASE=n8n
export DB_POSTGRESDB_HOST=postgresdb
export DB_POSTGRESDB_PORT=5432
export DB_POSTGRESDB_USER=n8n
export DB_POSTGRESDB_PASSWORD=n8n
export DB_POSTGRESDB_SCHEMA=n8n

# optional:
export DB_POSTGRESDB_SSL_CA_FILE=$(pwd)/ca.crt
export DB_POSTGRESDB_SSL_REJECT_UNAUTHORIZED=false

n8n start

필요한 권한#

n8n은 사용하는 테이블의 스키마를 생성하고 수정할 수 있어야 합니다.

권장 권한:

CREATE DATABASE n8n-db;
CREATE USER n8n-user WITH PASSWORD 'random-password';
GRANT ALL PRIVILEGES ON DATABASE n8n-db TO n8n-user;

TLS#

다음 구성 중에서 선택할 수 있습니다.

• 선언하지 않음(기본값): SSL=off로 연결
• CA와 unauthorized 플래그만 선언: SSL=on으로 연결하고 서버의 서명을 검증
• 위 항목과 함께 _{CERT,KEY}를 선언: 클라이언트 TLS 인증에 인증서와 키를 사용

SQLite#

아무것도 정의되지 않은 경우 사용되는 기본 데이터베이스입니다.

데이터베이스 파일은 다음 위치에 있습니다. ~/.n8n/database.sqlite

관련 자료#

• n8n 구성