Building from source

This method is not recommended for most users. To build Zipline from source, you will need to have the following dependencies installed:

• nodejs@22
• pnpm@10.2.0
• ffmpeg (for generating thumbnails, optional)

First, clone the repository:

git clone https://github.com/diced/zipline
cd zipline

Next, install the dependencies:

pnpm install

Before building Zipline, you will have to create a .env file, as well as have a PostgreSQL database running. An example .env looks like this:

# Replace username and password with your PostgreSQL credentials
DATABASE_URL=postgresql://username:password@localhost:5432/zipline

# These two are optional, but you can set them to change the hostname and port
CORE_HOSTNAME=0.0.0.0
CORE_PORT=3000

You will also need to generate a secret for zipline, to do this you can use the command below to append it to your .env file:

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

openssl rand -base64 42 | tr -dc A-Za-z0-9 | cut -c -32 | tr -d '\n'

Then build Zipline:

pnpm build

Finally, start the server:

pnpm start

To update Zipline, simply run the following command:

git pull

Then update dependencies and build Zipline:

pnpm install
pnpm build

Then start the server:

pnpm start