About tgState
tgState, listed here under the author's name Csz, is a self-hosted service written in Go that stores uploads in Telegram and serves them back through external links. It can act as an image host or as a simple network drive, and the project states that it places no limits of its own on file size or format.
Files can be uploaded through a web page or by sending them directly to the Telegram bot, and the bot can return a file ID that you append to your server address to reach the resource. Configuration covers a target (channel, group or user), the bot token, an optional access password, a mode that selects network-drive behavior or disables web upload, a base URL and a custom port. An HTTP API accepts form uploads, and a PicGo uploader setup is documented.
It is MIT licensed and can be deployed as a prebuilt Linux binary for amd64 or arm64, as a Docker container, or on Vercel, though the Vercel deployment cannot handle files larger than 5 MB. A guide for putting it behind Cloudflare is included. It suits individuals who want simple file or image hosting backed by their own Telegram bot.
Key features
- Telegram bot used as file storage
- Web upload and direct upload through Telegram
- Image hosting and network drive modes
- Optional access password
- HTTP upload API with JSON response
- Deploy via binary, Docker or Vercel
Good fit for
- →Image hosting for blogs or notes
- →Personal file sharing links
- →PicGo image uploads
- Built with
- Go
- Tags
- telegram
- file-sharing
- image-hosting
- file-upload
- go
- docker
- storage
- self-hosted
tgState: questions and answers
- What is tgState used for?
- tgState is a Go service that uses a Telegram bot as backend storage, giving uploaded files and images shareable external links. It is a good fit for image hosting for blogs or notes, personal file sharing links and PicGo image uploads.
- Is tgState open source?
- Yes. tgState is open source under the MIT licence. Its source code is on GitHub at csznet/tgState and is written mainly in Go.
- Is tgState free?
- Yes. tgState is open source, so the software itself is free to use.
- Can I self-host tgState?
- Yes. tgState can be self-hosted on your own server or infrastructure; there is no official hosted version.
- What is tgState an alternative to?
- tgState is an open-source alternative to Dropbox and Imgur. Other open-source alternatives to Dropbox include ownCloud Infinite Scale, Cloudreve and FileBrowser Quantum.
- Is tgState actively maintained?
- The most recent commit to tgState was on 13 April 2025, and the latest release is v1.4.1, published on 18 April 2024. The project has 1k stars on GitHub.
Open-source alternatives to tgState
See all
Zipline
File Storage & Sharing
A ShareX/file upload server that is easy to use, packed with features, and with an easy se
MITvs Imgur★ 3.4k
ownCloud Infinite Scale
File Storage & Sharing
:atom_symbol: ownCloud Infinite Scale
Apache-2.0vs Dropbox★ 2.1k
Cloudreve
File Storage & Sharing
🌩 Self-hosted file management and sharing system, supports multiple storage providers
GPL-3.0vs Dropbox★ 29k
FileBrowser Quantum
File Storage & Sharing
📂 Web File Browser
Apache-2.0vs Dropbox★ 8.5k
Kodbox
File Storage & Sharing
kodbox is a file manager for web. It is a newly designed product based on kodexplorer. It
OSSvs Dropbox★ 3.3k
FileGator
File Storage & Sharing
Powerful Multi-User File Manager
MITvs Dropbox★ 3.1k
SaaS alternatives to tgState
See all
Dropbox
File Storage & Sharing
Dropbox is cloud storage and file sharing with desktop and mobile apps, plus related tools for video review, e-signatures, document sharing and search.
SaaS
Imgur
Photos & Images
Image hosting and sharing community used for memes and quick uploads
SaaS
FileCloud
File Storage & Sharing
Self-hosted or cloud enterprise file sync and share platform
SaaS
Synology Drive
File Storage & Sharing
Private cloud file sync and sharing app that runs on Synology NAS devices
SaaS
Baidu Netdisk
File Storage & Sharing
Baidu cloud storage and file sharing service widely used in China
SaaS
Box
File Storage & Sharing
Cloud content management and file sharing platform for businesses
SaaS
