aahl

aahl / tgnas

Public

TgNAS is an S3-compatible and WebDAV-capable gateway backed by Telegram storage and local SQLite metadata.

zread.aiaahltgnas nas oss s3-compatible s3-storage telegram
45
9
85% credibility
Found May 27, 2026 at 46 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Go
AI Summary

TgNAS is a storage gateway that transforms Telegram into personal cloud storage. It accepts files through standard interfaces (S3-compatible and WebDAV) and stores them as messages in a Telegram chat, while keeping track of file metadata in a local database. Users can access their files using familiar tools like file managers, cloud storage browsers, or command-line utilities, without paying for traditional cloud storage services.

How It Works

1
💬 You hear about storing files in Telegram

You discover a clever way to use Telegram as free cloud storage, where your files live as messages in a chat.

2
🤖 You create a Telegram bot

You set up a new bot through Telegram's BotFather, which becomes your personal storage container.

3
🚀 You launch the storage service

With one Docker command, your storage gateway starts running, ready to accept files from your computer.

4
You access your storage your way
🖥️
S3-style access

Use tools like AWS Explorer or any S3-compatible app to browse and manage your files like any cloud drive.

🌐
WebDAV access

Mount your storage as a drive in Windows, macOS, or Linux, or use it directly in apps like file managers.

5
📤 You upload your first file

Drag and drop a file into your storage — it gets saved as a message in your Telegram chat, with metadata tracked locally.

✅ Your files are safely stored

Your documents, photos, and files live in Telegram, accessible from anywhere through your preferred tools — no monthly fees.

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 46 to 45 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is tgnas?

TgNAS is a storage gateway written in Go that turns Telegram into an S3-compatible object store with WebDAV support. Instead of paying for cloud storage, your files live in Telegram chats managed by a bot, while a local SQLite database tracks metadata. You get standard S3 operations (put, get, list, delete) and WebDAV file operations (MKCOL, COPY, MOVE) against buckets that map to Telegram chats. The service runs as a single binary or Docker container, serving both protocols on the same port.

Why is it gaining traction?

The appeal is obvious: free, unlimited storage if you already run Telegram bots. Developers tired of S3 bills are experimenting with it as a zero-cost alternative for personal projects. The dual S3/WebDAV interface means existing tools work out of the box -- s3cmd, AWS SDKs, rclone, even file managers that speak WebDAV. Presigned URLs work for sharing files temporarily. Multipart uploads handle large files in chunks. The project also ships with CLI commands to inspect metadata without starting the server, useful for debugging.

Who should use this?

Developers self-hosting small projects who want free object storage without vendor lock-in. Homelab enthusiasts running Telegram bots already. Anyone building tools that need S3-compatible storage but want to avoid AWS fees. Not suitable for production systems requiring guaranteed durability or performance SLAs.

Verdict

The concept is clever and the implementation is functional, but the 0.8500000238418579% credibility score reflects a young project with only 45 stars. Test coverage looks solid from what I can see, and Docker deployment is straightforward, but documentation is minimal. Worth experimenting with for personal or non-critical use, but wait for more community validation before betting on it for anything important.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.