Skip to content


Repository files navigation

GitHub license Chat / Support Support me Support me

What is Chibisafe?

Chibisafe is a file uploader service written in typescript that just works. It's easy to use, easy to deploy, free and open source. It accepts files, photos, documents, anything you imagine and gives you back a shareable link for you to send to others.

You can run it in public mode, user accounts mode or invite-only mode. Big files are automatically chunked to minimize network failure and users can create an API key to use the service programatically and hook it to other things.

The service also comes with a dashboard where you can edit almost every configuration of the instance directly from the UI without having to touch environment or configuration files manually. Control the name, the rate limit, max file size, accepted extensions, meta descriptions, etc directly from our intuitive panel.

If you fork/deploy your own instance it would mean a lot if you were to keep either the GitHub logo to our repo or a link to it ๐Ÿ’–

Features of v6 aka Holo

  • ๐Ÿ“„ Beautiful docs
  • ๐Ÿ—„๏ธ S3 Storage Support
  • ๐Ÿ“ท Beautiful masonry to browse media files
  • โœจ Chunked uploads for big files
  • ๐Ÿ”— Share direct links to uploaded files
  • ๐Ÿ“‚ Albums/Folders with direct links to share
  • ๐Ÿ“ Snippets/Gists creation with direct links to share
  • ๐Ÿ—ƒ๏ธ File management and file tagging
  • ๐Ÿ™‹ User management and quotas
  • ๐Ÿ”— Built-in URL shortener
  • โœ‰๏ธ Public or Private mode (with invite support)
  • โฌ†๏ธ ShareX support out-of-the-box to upload screenshots/screenrecordings from your desktop
  • ๐Ÿ“ฑ iOS shortcut to upload files through the share menu
  • ๐ŸŒ Browser extension to upload content from websites easily
  • ๐Ÿงฉ Easily extensible
  • ๐Ÿ“– Open source
  • ๐Ÿšซ No ads and no tracking (except for IP logging of requests)

Installing and running chibisafe

Whichever method you choose to install chibisafe keep in mind that the installation process creates an account named admin with the same password. Once you log in the first time make sure to change it! Also we highly recommend using docker for chibisafe.

For more guides and how to set up different aspects of the service please refer to the guides

Migrate from older versions

v5 to v6

If you come from v5 you might be used to chibisafe exposing 1 single port for you to reverse proxy into nginx/caddy/apache. Starting from v6 this is also the case (although port is now 24424) as long as you run the configuration we provide with docker. Other than configuring your reverse proxy accordingly, all you need to do to migrate is to copy both the uploads/ and database/ folders into your new instance folder. Once chibisafe starts it will apply the necessary migrations automatically.


Migrating from an older version than v5 to v6 is not possible, so we recommend setting up a new instance instead.


msedge_AjPLFovUHQ msedge_UH0h77QQoc msedge_BlsPiNf53x msedge_iIXnaUohh6


Chibisafe ยฉ Pitu, Released under the MIT License.
Authored and maintained by Pitu.