7,363 open-source and SaaS tools, with GitHub stats refreshed every day.

tgState

Open source

tgState is a Go service that uses a Telegram bot as backend storage, giving uploaded files and images shareable external links.

Open-source alternative to

csz.net
tgState homepage screenshot
GitHub stars
1k
Last commit
1 yr ago
Repository age
3 years
Version
v1.4.1
Licence
MIT
Self-hosted
Yes

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

SaaS alternatives to tgState

See all