Docker

Install & run with Docker Compose

First, download the docker-compose.yml file using curl or wget with the following command:

curl -LO https://zipline.diced.sh/docker-compose.yml

If you don't already have a .env file with a database password and zipline secret, you can generate one with the following command:

echo "POSTGRESQL_PASSWORD=$(openssl rand -base64 42 | tr -dc A-Za-z0-9 | cut -c -32 | tr -d '\n')" > .env
echo "CORE_SECRET=$(openssl rand -base64 42 | tr -dc A-Za-z0-9 | cut -c -32 | tr -d '\n')" >> .env
Note

What does this command do?

openssl rand -base64 42 | tr -dc A-Za-z0-9 | cut -c -32 | tr -d '\n'
  • openssl rand -base64 42: Generate 42 random bytes in base64 encoding.
  • tr -dc A-Za-z0-9: Remove all characters except for letters and numbers.
  • cut -c -32: Cut the string to 32 characters.
  • tr -d '\n': Remove the newline character.
Danger

Zipline will fail to start without the POSTGRESQL_PASSWORD and CORE_SECRET variables.

Info

You will also want to setup a datasource for your instance. By default, Zipline will use ./uploads (the docker-compose.yml also includes a volume for this) for local file storage. You can configure a different datasource (e.g. S3) by setting the appropriate environment variables in the .env file.

Finally, run the following command to start the Zipline server:

docker compose pull
docker compose up -d

After starting, Zipline will be available at http://<ip>:3000 where <ip> is the IP address of the machine running Zipline.

You will be redirected to a setup page where you can configure the default super administrator username and password.

Extra resources:

Updating

To update Zipline, simply run the following command:

docker compose pull
docker compose up -d

This will pull the latest Zipline image and restart the server.



Last updated: 2/17/2025
Edit this page on GitHub