데이터베이스 환경 변수

요약

개별 변수에 _FILE을 추가하여 별도의 파일에서 구성을 제공할 수 있습니다. 기본적으로 n8n은 SQLite를 사용합니다. 이 페이지에서는 셀프 호스팅 n8n 인스턴스에서 선택한 데이터베이스를 구성하기 위한 환경 변수를 설명합니다.

파일 기반 구성

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

기본적으로 n8n은 SQLite를 사용합니다. n8n은 PostgreSQL도 지원합니다. n8n은 v1.0에서 MySQL 및 MariaDB 지원을 deprecated했습니다.

이 페이지에서는 셀프 호스팅 n8n 인스턴스에서 선택한 데이터베이스를 구성하기 위한 환경 변수를 설명합니다.

변수	타입	기본값	설명
`DB_TYPE` /`_FILE`	Enum string: `sqlite`, `postgresdb`	`sqlite`	사용할 데이터베이스입니다.
`DB_TABLE_PREFIX`	*	-	테이블 이름에 사용할 접두사입니다.
`DB_PING_INTERVAL_SECONDS`	Number	`2`	데이터베이스 연결이 유지되는지 확인하기 위한 핑 간격(초)입니다.

PostgreSQL#

변수	타입	기본값	설명
`DB_POSTGRESDB_DATABASE` /`_FILE`	String	`n8n`	PostgreSQL 데이터베이스 이름입니다.
`DB_POSTGRESDB_HOST` /`_FILE`	String	`localhost`	PostgreSQL 호스트입니다.
`DB_POSTGRESDB_PORT` /`_FILE`	Number	`5432`	PostgreSQL 포트입니다.
`DB_POSTGRESDB_USER` /`_FILE`	String	`postgres`	PostgreSQL 사용자입니다.
`DB_POSTGRESDB_PASSWORD` /`_FILE`	String	-	PostgreSQL 비밀번호입니다.
`DB_POSTGRESDB_POOL_SIZE` /`_FILE`	Number	`2`	n8n이 유지할 병렬 Postgres 연결 수를 제어합니다. 값을 높이면 리소스 활용도가 향상될 수 있지만, 연결이 너무 많으면 성능이 저하될 수 있습니다.
`DB_POSTGRESDB_CONNECTION_TIMEOUT` /`_FILE`	Number	`20000`	Postgres 연결 타임아웃(ms)입니다.
`DB_POSTGRESDB_IDLE_CONNECTION_TIMEOUT` /`_FILE`	Number	`30000`	유휴 연결이 유휴 상태로 제거 대상이 되기까지의 시간입니다.
`DB_POSTGRESDB_SCHEMA` /`_FILE`	String	`public`	PostgreSQL 스키마입니다.
`DB_POSTGRESDB_SSL_ENABLED` /`_FILE`	Boolean	`false`	SSL 활성화 여부입니다. `DB_POSTGRESDB_SSL_CA`, `DB_POSTGRESDB_SSL_CERT` 또는 `DB_POSTGRESDB_SSL_KEY`가 정의된 경우 자동으로 활성화됩니다.
`DB_POSTGRESDB_SSL_CA` /`_FILE`	String	-	PostgreSQL SSL 인증 기관입니다.
`DB_POSTGRESDB_SSL_CERT` /`_FILE`	String	-	PostgreSQL SSL 인증서입니다.
`DB_POSTGRESDB_SSL_KEY` /`_FILE`	String	-	PostgreSQL SSL 키입니다.
`DB_POSTGRESDB_SSL_REJECT_UNAUTHORIZED` /`_FILE`	Boolean	`true`	n8n이 인증되지 않은 SSL 연결을 거부할지(true) 여부(false)입니다.

SQLite#

변수	타입	기본값	설명
`DB_SQLITE_POOL_SIZE`	Number	`0`	SQLite 파일을 WAL 모드로 열지, 롤백 저널 모드로 열지를 제어합니다. 0으로 설정하면 롤백 저널 모드를 사용합니다. 0보다 크면 WAL 모드를 사용하며, 해당 값이 병렬 SQL 읽기 연결 수를 결정합니다. WAL 모드는 롤백 저널 모드보다 훨씬 성능이 우수하고 안정적입니다.
`DB_SQLITE_VACUUM_ON_STARTUP`	Boolean	`false`	시작 시 VACUUM 작업을 실행하여 데이터베이스를 재구성합니다. 파일 크기를 줄이고 인덱스를 최적화합니다. 이 작업은 오래 걸리는 블로킹 작업으로 시작 시간이 늘어납니다.

데이터베이스 환경 변수

원문 보기

번역일: 2026-03-12

요약

파일 기반 구성

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

기본적으로 n8n은 SQLite를 사용합니다. n8n은 PostgreSQL도 지원합니다. n8n은 v1.0에서 MySQL 및 MariaDB 지원을 deprecated했습니다.

이 페이지에서는 셀프 호스팅 n8n 인스턴스에서 선택한 데이터베이스를 구성하기 위한 환경 변수를 설명합니다.

변수	타입	기본값	설명
`DB_TYPE` /`_FILE`	Enum string: `sqlite`, `postgresdb`	`sqlite`	사용할 데이터베이스입니다.
`DB_TABLE_PREFIX`	*	-	테이블 이름에 사용할 접두사입니다.
`DB_PING_INTERVAL_SECONDS`	Number	`2`	데이터베이스 연결이 유지되는지 확인하기 위한 핑 간격(초)입니다.

PostgreSQL#

변수	타입	기본값	설명
`DB_POSTGRESDB_DATABASE` /`_FILE`	String	`n8n`	PostgreSQL 데이터베이스 이름입니다.
`DB_POSTGRESDB_HOST` /`_FILE`	String	`localhost`	PostgreSQL 호스트입니다.
`DB_POSTGRESDB_PORT` /`_FILE`	Number	`5432`	PostgreSQL 포트입니다.
`DB_POSTGRESDB_USER` /`_FILE`	String	`postgres`	PostgreSQL 사용자입니다.
`DB_POSTGRESDB_PASSWORD` /`_FILE`	String	-	PostgreSQL 비밀번호입니다.
`DB_POSTGRESDB_POOL_SIZE` /`_FILE`	Number	`2`	n8n이 유지할 병렬 Postgres 연결 수를 제어합니다. 값을 높이면 리소스 활용도가 향상될 수 있지만, 연결이 너무 많으면 성능이 저하될 수 있습니다.
`DB_POSTGRESDB_CONNECTION_TIMEOUT` /`_FILE`	Number	`20000`	Postgres 연결 타임아웃(ms)입니다.
`DB_POSTGRESDB_IDLE_CONNECTION_TIMEOUT` /`_FILE`	Number	`30000`	유휴 연결이 유휴 상태로 제거 대상이 되기까지의 시간입니다.
`DB_POSTGRESDB_SCHEMA` /`_FILE`	String	`public`	PostgreSQL 스키마입니다.
`DB_POSTGRESDB_SSL_ENABLED` /`_FILE`	Boolean	`false`	SSL 활성화 여부입니다. `DB_POSTGRESDB_SSL_CA`, `DB_POSTGRESDB_SSL_CERT` 또는 `DB_POSTGRESDB_SSL_KEY`가 정의된 경우 자동으로 활성화됩니다.
`DB_POSTGRESDB_SSL_CA` /`_FILE`	String	-	PostgreSQL SSL 인증 기관입니다.
`DB_POSTGRESDB_SSL_CERT` /`_FILE`	String	-	PostgreSQL SSL 인증서입니다.
`DB_POSTGRESDB_SSL_KEY` /`_FILE`	String	-	PostgreSQL SSL 키입니다.
`DB_POSTGRESDB_SSL_REJECT_UNAUTHORIZED` /`_FILE`	Boolean	`true`	n8n이 인증되지 않은 SSL 연결을 거부할지(true) 여부(false)입니다.

SQLite#

변수	타입	기본값	설명
`DB_SQLITE_POOL_SIZE`	Number	`0`	SQLite 파일을 WAL 모드로 열지, 롤백 저널 모드로 열지를 제어합니다. 0으로 설정하면 롤백 저널 모드를 사용합니다. 0보다 크면 WAL 모드를 사용하며, 해당 값이 병렬 SQL 읽기 연결 수를 결정합니다. WAL 모드는 롤백 저널 모드보다 훨씬 성능이 우수하고 안정적입니다.
`DB_SQLITE_VACUUM_ON_STARTUP`	Boolean	`false`	시작 시 VACUUM 작업을 실행하여 데이터베이스를 재구성합니다. 파일 크기를 줄이고 인덱스를 최적화합니다. 이 작업은 오래 걸리는 블로킹 작업으로 시작 시간이 늘어납니다.