Self-host Jirafeau
4.7.1One-click file sharing with expiring links
docker run -it --rm -p 8080:80 registry.gitlab.com/jirafeau/jirafeau:latest- Port
- 80 (HTTP inside the container (lighttpd); the documented example publishes it as 8080 on the host)
registry.gitlab.com/jirafeau/jirafeauWhat is Jirafeau?
Jirafeau is a lightweight PHP web application for one-click file sharing: you pick a file, upload it, and receive a link to hand out together with a separate link for deleting the upload. It deliberately avoids a database and only needs basic PHP, which keeps the dependency list tiny. Uploads can be far larger than typical PHP limits because the HTML5 file API splits the transfer into chunks, progress is displayed during upload, and files are previewed in the browser when possible. Uploaders can protect downloads with a password (optional, mandatory or auto-generated), choose an expiry from one minute up to unlimited, or make a link self-destruct after the first download; operators can additionally gate the upload page with passwords or allowed IP ranges. Optional server-side encryption uses XChaCha20-Poly1305 and puts the decrypt key only in the download URL, while file hashing can deduplicate identical uploads to save disk space. A small administration page at /admin.php, a scripting endpoint at /script.php with a bash helper for command-line uploads, many locales, themes including a dark variant and a CLI cleanup command for cron cover the maintenance side. Self-hosting means either a git clone or a release download on any PHP 7.4+ web server with a browser-based setup wizard, or the Alpine/lighttpd container image published on GitLab's registry, which is configured through environment variables. This GitLab project is the continuation of the discontinued original Jirafeau by Jerome Jutteau, itself forked from Jyraphe, and is released under AGPL-3.0.
Jirafeau alternatives
filesharingFileSharing is a self-hosted, open-source file sharing app like WeTransfer with secure links, no database needed.Comparefilesharing with Jirafeau
GiraffileGiraffile is an open-source web app for private P2P file sharing between browsers using WebRTC, with automatic file expiration and no intermediary servers.CompareGiraffile with Jirafeau
ErugoErugo is an open-source, self-hosted file sharing platform with memorable URLs, password protection, expiration dates, download limits, and a customizable dashboard.CompareErugo with Jirafeau
PlikShareOpen-source self-hosted file sharing with unlimited users, multiple storage backends, three encryption modes, OIDC SSO, TOTP 2FA, sharing boxes, and MCP for AI agents.ComparePlikShare with Jirafeau
fileshelterSelf-hosted file sharing application that lets you upload files and share them via unique URLs with expiration, password protection, and multi-file zip creation.Comparefileshelter with Jirafeau
ferrishareSelf-hosted file sharing with browser-side encryption so the server never sees content. Single container with SQLite, admin panel, rate limiting, configurable expiration.Compareferrishare with Jirafeau
ProjectSendSelf-hosted, open-source client file sharing: each client gets a private portal, with expiring links, quotas, LDAP/2FA sign-in, S3 storage and a REST API.CompareProjectSend with Jirafeau
quickdropQuickDrop is an open-source, self-hosted file sharing app with pastebin and URL shortener. Chunked uploads, per-file encryption, expiring share links.Comparequickdrop with Jirafeau
Should you self-host Jirafeau?
Jirafeau scores 58/100 on selfhost.directory (how scoring works) and ranks #27 of 89 in File Sharing.
There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.
Setup is easy: most people get it running in one sitting. An official Docker image is available. It is AGPL-3.0-licensed.
Its closest alternative on selfhost.directory is copyparty (82/100, 47 424 stars). It scores higher overall, so compare the two before you pick. See Jirafeau vs copyparty side by side.
Features
- Admin Interface
- Basic API / scripting interface
- CLI cleanup of expired files
- File-level deduplicationEnabled through the file_hash option.
- In-browser file preview
- Large file uploads via HTML5 file API
- Link expiration
- Multi-language Support
- One-click file upload with download and delete links
- Password protection for uploads and downloads
- Self-destruct after first download
- Server-Side EncryptionNeeds the Sodium PHP module; disables deduplication and is not end-to-end encryption.
- Short download links
- Upload progress display
How to install Jirafeau
Install Jirafeau with Docker
ADMIN_PASSWORD, ADMIN_IP, LANG, AVAILABILITIES, WEB_ROOT, VAR_ROOT, FILE_HASH, PREVIEW, TITLE, ORGANISATION, CONTACTPERSON, STYLE, DARK_STYLE, AVAILABILITY_DEFAULT, ONE_TIME_DOWNLOAD, ONE_TIME_DOWNLOAD_PRESELECTED, ENABLE_CRYPT, DEBUG, MAXIMAL_UPLOAD_SIZE, UPLOAD_PASSWORD, UPLOAD_IP, UPLOAD_IP_NO_PASSWORD, PROXY_IP, STORE_UPLOADER_IP, DOWNLOAD_PASSWORD_REQUIREMENT, DOWNLOAD_PASSWORD_GEN_LEN, DOWNLOAD_PASSWORD_GEN_CHARS, DOWNLOAD_PASSWORD_POLICY, DOWNLOAD_PASSWORD_POLICY_REGEXdocker pull registry.gitlab.com/jirafeau/jirafeau:latest
docker run -it --rm -p 8080:80 registry.gitlab.com/jirafeau/jirafeau:latest
Container images are built for AMD64 and ARM64. TLS is not provided by the image; data lives in /data by default and the admin password is auto-generated (shown in the container log) unless ADMIN_PASSWORD is set.
FAQ
What about this file deduplication thing?
Repeated uploads of the same file are stored once with a reference counter; the file is destroyed when the counter reaches zero. It is disabled by default and enabled through the file_hash option.
How can I monitor the use of my Jirafeau instance?
Munin with simple scripts can collect the number of files and the disk space they occupy.
How can I use the scripting interface (API)?
Point your browser at /script.php.
How can I access the admin interface?
Open /admin.php in your browser.
How can I change the Terms of Service?
Copy lib/tos.original.txt to lib/tos.local.txt and edit it; updates only ever touch the original file.
How to set maximum file size?
Browsers with the HTML5 file API can upload arbitrarily large files; otherwise the limits come from PHP's post_max_size and upload_max_filesize, and Jirafeau's maximal_upload_size setting can cap it.
How can I change the theme?
Set the style key in lib/config.local.php to a folder name in /media; use dark_style for the dark-mode theme.
How can I automatize the cleaning of old (expired) files?
Run admin.php from the command line with the clean_expired or clean_async commands and place it in a cron entry.
How can I limit upload access?
Set one or more passwords for the upload page and/or a list of allowed IPs in CIDR notation; downloads cannot be limited this way.
Can I add a new language in Jirafeau?
Yes, create a new JSON file under lib/locales and submit it as a merge request.
More in File Sharing
JmalCloudSelf-hosted, open-source personal cloud drive: online Office editing, previews, WebDAV mounting, resumable big uploads and full-text search, shipped as a Docker image.
KeepShareKeepShare is a self-hosted, open-source file hosting automation tool that converts Magnet/DDL/Ed2K links into hosted shares, supports PikPak, auto-repairs banned shares
Kiwix ServerOpen-source CLI utilities for managing and serving ZIM files offline. Includes kiwix-serve for HTTP, kiwix-manage for libraries, and kiwix-search for full-text search.
kodboxkodbox is a self-hosted, open-source PHP file manager and private cloud drive: multi-storage mounting, fine-grained permissions, sharing, and online preview/edit.
kuboKubo is the original open-source Go implementation of IPFS: a self-hosted p2p daemon for content-addressed data, with a CLI, WebUI, HTTP gateway and RPC API.
Local Content ShareSelf-hosted, open-source tool for sharing snippets, files, and links across local devices. Features Markdown notepad, configurable TTL, and PWA support.
LufiSelf-hosted Docker deployment of Lufi, a file sharing service supporting temporary links, password protection, LDAP authentication, and multiple database backends.
lufinLufin is an open-source, self-hosted file sharing service with client-side encryption, password protection, and support for multiple databases and S3 storage.
MicroBinSelf-hosted, open-source paste bin in a single Rust binary: share text, files and URL redirects with five privacy levels, E2E encryption, expiry and QR codes.
minimalistic-PHP-UploadA simple self-hosted PHP upload script that lets users upload files and sends email notifications with download links. No database required.
mouseholeMousehole is a self-hosted service that keeps your MyAnonamouse seedbox IP updated automatically, with a web UI to manage the MAM cookie and trigger manual updates.
NextCloudPiA self-hosted, open-source Nextcloud package delivered as SD images, VM and LXC images, or a one-line Debian installer, with a web admin panel.




0 comments