The following guides will help you get started with Zipline.

Docker

Building from source

Getting Started

This page documents and guides you through setting up OAuth for Zipline.

This page guides you through setting up Discord OAuth for Zipline.

Discord

This page guides you through setting up GitHub OAuth for Zipline.

GitHub

This page guides you through setting up Google OAuth for Zipline.

Google

This page documents and guides you through setting up Open ID Connect (OIDC) for Zipline. If you are having trouble configuring a different OIDC provider that is not listed here, feel free to join the Discord and ask for help.

OIDC

OAuth

Zipline can generate a .sxcu (ShareX Custom Uploader) file for you to use with ShareX. With this you can easily upload files to your Zipline instance using ShareX.

ShareX

This section requires Flameshot, jq, and xsel.

Flameshot

iOS: Shortcuts

This guide uses the github.com/tsudoku/xshare app as a way to upload files from an Android device.

Android: xshare

This guide will show you how to generate a shell-script that takes an argument (file/url) and uploads it to Zipline.

Shell Script

Uploaders

Zipline provides a command line utility called ziplinectl to manage specific parts of your Zipline instance.

ziplinectl

Output the current configuration as JSON.

ziplinectl read-config

Import a directory of files into Zipline.

ziplinectl import-dir

ziplinectl set-user

Lists all users in Zipline in a JSON format.

ziplinectl list-users

Command Line

2 Factor Authentication with TOTP (time-based one-time password) is a security feature that adds an extra layer of protection to your account. It requires you to enter a code from your phone (an app like 2FAS, Authy, Google Authenticator, etc.) in addition to your password when logging in.

Some settings use human readable byte sizes. Here is a table of the byte sizes and their human readable counterparts.

Bytes

Zipline offers a couple of settings that let you customize the dashboard to your liking. This guide will walk you through the available options.

Customizing the Dashboard

Enabling debug mode will show more verbose logs. This is mostly useful when debugging an issue with Zipline.

Debug

Discord webhooks are a simple way to get "notifications" sent to a text channel in your Discord server. Zipline offers a way to send notifications to a Discord webhook whenever a file is uploaded or a URL is shortened.

Discord Webhooks

External links are links configured to show up on the bottom of the sidebar.

External Links

If you have enabled HTTP Webhooks within the dashboard settings, Zipline will send a POST request to the URL with the file/url information.

HTTP Webhooks

Some settings use human readable relative time. Here is a table of the time units and their human readable counterparts.

Milliseconds

Passkeys are a way to authenticate users without requiring them to enter a password. Instead, users can click "Login with a passkey" and follow their device prompts to authenticate.

Passkeys

Zipline is currently being maintained by me (@diced) and only me. New releases can come out frequently or take a while depending on my schedule. If a new minor/patch release (4.x.x) is not out, you can build from source or use the trunk tag on docker for the latest commit version.

Releases

This page will guide you through setting up a reverse proxy for Zipline using various different methods.

Reverse Proxy

These are small "maintenance" actions that can be performed on the server. This section is found under the "Settings" button when clicking your user icon in the top right corner.

Server Actions

Zipline supports using SSL natively through the SSLCERT and SSLKEY environment variables.

You can create custom themes for Zipline by adding JSON files within the themes/ directory (relative to the root of Zipline).

Themes

Video Thumbnails are generated by ffmpeg and are used to display a preview image of the video file. Thumbnails are generated on a scheduled interval, but you can also generate them manually.

Video Thumbnails

Upload options are HTTP headers that can be used to change various settings for file uploads.

Upload Options

Variables can be used in Discord Webhook messages and the view route to customize the message with dynamic content.

Variables

View Routes on Zipline allow you to customize the appearance of files when they are viewed through the browser. By this we mean that instead of just showing the raw file and letting the browser handle it, the file is rendered in a more "user-friendly" way.

View Routes

Having trouble taking screenshots or recording on Wayland (Linux)? Here are a bunch of different ways to do both of those things. Most problems arise when using a wlroots based compositor, it's easier when using GNOME or KDE with Flameshot.

Wayland Guide

Guides

This page will document every configuration option available in Zipline through environment variables, as well as through the settings dashboard.

This page documents the core configuration options available.

Core

This page will document the configuration options available for the datasource.

Datasource

This page documents the configuration options available for SSL. Both the SSLCERT and SSLKEY environment variables are required to enable SSL.

As of Zipline v4, most configuration options can be managed through the settings dashboard. However, some settings require a server restart.

Settings

Config

This guide will help you migrate from v3 to v4

Migrate From v3

Contributions of any kind are welcome, whether they are bug reports, pull requests, or feature requests.