Core

This page documents the core configuration options available.

DATABASE_URL

DATABASE_URL is a required environment variable, Zipline will fail to start without it.

This variable should be a postgresql connection string.

DATABASE_URL=postgresql://user:password@localhost:5432/zipline

If you prefer, you can also set the individual components of the connection string using the following environment variables: DATABASE_NAME, DATABASE_USER, DATABASE_PASSWORD, DATABASE_HOST, and DATABASE_PORT.

DATABASE_NAME=zipline
DATABASE_USER=user
DATABASE_PASSWORD=password
DATABASE_HOST=localhost
DATABASE_PORT=5432
Note

If both DATABASE_URL and the individual components are provided, DATABASE_URL will take precedence.

If any one of the individual components are missing, Zipline will fail to start.

CORE_HOSTNAME

CORE_HOSTNAME is an optional environment variable that specifies the hostname that Zipline will bind to, it defaults to 0.0.0.0. If using Docker, you can set this to 0.0.0.0 so that you can access Zipline from outside the container (with a exposed port).

CORE_HOSTNAME=127.0.0.1
CORE_HOSTNAME=0.0.0.0

CORE_PORT

CORE_PORT is an optional environment variable that specifies the port that Zipline will bind to, it defaults to 3000.

CORE_PORT=3000

CORE_SECRET

CORE_SECRET is a required environment variable that is used to sign website cookies, and should be kept private. It is recommended to generate this value using a password manager, or with the following command:

openssl rand -base64 32 # 32 is the length, you can change this
CORE_SECRET="p5g9NUcnpSbSl+N/70rlv+YXcoL5X0LA6fTc8Anz74w="


Last updated: Nov 12, 2025
Edit this page on GitHub