# Zipline

Zipline is a self-hosted file upload and sharing server that provides URL shortening, embeds, image compression, video thumbnails, and a web dashboard for managing files, users, and permissions, offering homelab users. It is open source and self-hosted, installable on Docker Hub, TrueNAS, Proxmox, Unraid and ZimaOS.

Canonical page: https://ourlocalhost.com/app/1668/zipline

## Description

Zipline is a self-hosted file upload and sharing server that provides URL shortening, embeds, image compression, video thumbnails, and a web dashboard for managing files, users, and permissions, offering homelab users a self-hosted alternative to cloud file-sharing services.

## Platform availability

Available on 5 of 10 platforms: Unraid, TrueNAS, ZimaOS, Proxmox, Any server.

## Health score

88/100 (Excellent), based on 4 of 5 factors.
- Maintained: 100 (last commit 12 days ago)
- Popular: 71 (3,496 GitHub stars)
- Easy to install: 75 (5 install platforms, install notes, Docker image)
- Security check: 100 (no serious findings, CI, tests)

## Links

- Docker Hub: https://hub.docker.com/r/diced/zipline
- TrueNAS: https://apps.truenas.com/catalog/zipline/
- Proxmox: https://community-scripts.github.io/ProxmoxVE/scripts?id=zipline
- GitHub: https://github.com/diced/zipline
- Official website: https://zipline.diced.sh/
- Unraid: https://ca.unraid.net/apps/zipline-1t5usi81dna0d0?q=Zipline
- Documentation: https://v3.zipline.diced.sh
- ZimaOS: https://github.com/bigbeartechworld/big-bear-casaos/tree/master/Apps/zipline

## Common questions

### What PostgreSQL connection is needed when deploying Zipline on Unraid?

The Unraid configuration requires an external PostgreSQL 16 or higher database, and you must provide its connection string. The web UI starts on default port 8092, and settings are under /dashboard/admin/settings.

### Can I use a mobile client with a self-hosted Zipline server?

Yes, there is a Zipline Android client for self-hosted Diced/Zipline v4 servers. It can upload, share, download, and manage files and short URLs, and it includes a stats widget with upload shortcuts.

### Does Zipline support OAuth2 and two-factor authentication?

Zipline can allow users to register or link selected OAuth2 providers. Users can also enable two-factor authentication.

### Can Zipline create shortened links?

Yes, it can shorten URLs with vanity links and maximum view limits.

### Does Zipline work with ShareX for screen-capture sharing?

A self-hoster reports that ShareX on Windows works with a self-hosted Zipline file upload and URL shortener setup for screen-capture sharing.

---
Source: Our Local Host (https://ourlocalhost.com/app/1668/zipline), the self-hosted and open-source app directory.
