# Handoff

Handoff is a self-hosted cloud app. Handoff turns a file or folder on your server into a shareable download link with an expiry date. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/2874/handoff

## Description

Handoff turns a file or folder on your server into a shareable download link with an expiry date. Mount a folder the way you would for any container and browse it in the admin interface. Click a file to share it and it is served straight off the share, so nothing is copied and no extra disk is used. Or share a whole folder and Handoff zips it once with no compression, which is the fast option for photos and video since they do not compress anyway. You can also drag a file into the browser to upload it. Every link can carry an expiry, an optional password, and an optional download limit. When a link expires it is deleted, along with anything Handoff created for it — an upload or a generated archive. Your mounted folder is read-only to Handoff — it is only ever read from, never written to or deleted from. Note on disk space: generated archives are written to the Appdata path, so zipping a

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

40/100 (Fair), based on 4 of 4 factors.
- Maintained: 68 (last commit 97 days ago)
- Popular: 6 (1 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 30 (4 GB minimum RAM)

## Links

- Unraid: https://ca.unraid.net/apps/handoff-1wwlycd1am76yx?q=handoff

## Common questions

### Where should I mount the shared folder and generated archives?

Mount the source folder as /library read-only, and use the /data appdata volume for anything Handoff creates. The /data volume needs room for the largest folder you plan to zip.

### What port does the Handoff web UI use?

The web UI uses port 8080. In Docker, expose the container with 8080:8080.

### What must I configure to expose Handoff through a reverse proxy without 403 or broken login?

Handoff speaks plain HTTP and expects a proxy in front. Set PUBLIC_URL or ALLOWED_HOSTS to the hostname you use, and set TRUST_PROXY=1 only when a proxy forwards X-Forwarded-* headers.

### Does the admin password also protect shared download links?

The admin password gates the admin UI only, not share links. Share links can still carry their own optional password, expiry, and download limit.

### Can interrupted file transfers be resumed?

Downloads can resume because Range requests are supported, so a large download resumes instead of restarting. Uploads are not resumable, so put anything huge on the share instead.

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