Chibisafe

Chibisafe

Docker app from professeurx's Repository

Overview

Chibisafe is a file uploader service written in node that aims to to be easy to use and easy to set up. It's mainly intended for images and videos, but it accepts anything you throw at it. You can run it in public or private mode, making it so only people with user accounts can upload files as well as controlling if user signup is enabled or not. Out of the box support for ShareX configuration letting you upload screenshots and screenrecordings directly to your chibisafe instance. Browser extension to be able to right click any image/video from any website and upload it directly to your chibisafe instance. Chunk uploads enabled by default to be able to handle big boi files. API Key support so you can integrate the service with whatever you desire. Albums, tags and Discord-like search function User list and control panel

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.

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

Screenshots

msedge_AjPLFovUHQ msedge_UH0h77QQoc msedge_BlsPiNf53x msedge_iIXnaUohh6

Author

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

Install Chibisafe on Unraid in a few clicks.

Find Chibisafe in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for Chibisafe Review the template variables and paths Click Install

Requirements

!For the first configuration please enter admin/ admin, go to users = > New users= > enter user / password give it administrator permissions according to your convenience !

! Modify the variable DOMAIN " http://IPUNRAID:PORT " to be able to access chibisafe !

Related apps

Details

Repository
pikatsuto/chibisafe
Last Updated2026-07-14
First Seen2026-05-13

Runtime arguments

Web UI
http://[IP]:[PORT:5000]
Network
bridge
Shell
sh
Privileged
false

Template configuration

Host Port 1Porttcp
Target
5000
Value
8056
pathPathrw
Target
/usr/chibisafe/uploads
Value
/mnt/user/appdata/chibisafe
ADMIN_ACCOUNTVariable
Default
admin
Value
admin
PUBLIC_MODEVariable
Default
true
Value
false
ADMIN_PASSWORDVariable
Default
admin
Value
admin
DB_CLIENTVariable
Default
sqlite3
Value
sqlite3
SERVICE_NAMEVariable
Default
chibisafe
Value
chibisafe
DB_HOSTVariable
DB_USERVariable
DB_PASSWORDVariable
DB_DATABASEVariable
SERVER_PORTVariable
Default
5000
Value
5000
DOMAINVariable

http://IPUNRAID:PORT

Value
http://IPUNRAID:PORT
ROUTE_PREFIXVariable
Default
/api
Value
/api
OVERWRITE_SETTINGSVariable
Default
false
Value
false
CHUNK_SIZEVariable
Default
90
Value
90
USER_ACCOUNTSVariable
Default
true
Value
true
RATE_LIMIT_WINDOWVariable
Default
2
Value
2
RATE_LIMIT_MAXVariable
Value
5
MAX_LINKS_PER_ALBUMVariable
Value
5
META_THEME_COLORVariable
Value
#20222b
BLOCKED_EXTENSIONSVariable
Value
.jar,.exe,.msi,.com,.bat,.cmd,.scr,.ps1,.sh
META_TWITTER_HANDLEVariable