teamgram/teamgram-server

Unofficial open source mtproto server written in golang with compatible telegram client.

2,276

1,357 commits

updated Aug 4, 2026

teamgram.net

See the code

README

Teamgram Server

中文 | English

Unofficial open-source MTProto server implementation in Go. Compatible with Telegram clients; supports self-hosted deployment.

Features

MTProto 2.0
- Abridged
- Intermediate
- Padded intermediate
- Full
API Layer: 228
Core features
- private chat
- basic group
- contacts
- web

Architecture

Architecture Docs - DeepWiki teamgram/teamgram-server
Architecture (specs) — service topology, data flow, and ports
Service topology and configuration — ports, infrastructure dependencies, call graph, and Mermaid diagram (中文)

Prerequisites

Component	Purpose
MySQL 5.7+ / 8.0	Primary data store
Redis	Cache, session, deduplication
etcd	Service discovery & config
Kafka	Message & event pipeline
MinIO	Object storage
FFmpeg	Media transcoding (on server)

Detailed versions and optional monitoring stack: Dependencies and runtime (specs).

Manual installation

For running the server from source (Go build), follow the step-by-step guides:

Manual installation (Linux) — CentOS, Fedora, Ubuntu/Debian
Manual installation (macOS) — Intel and Apple Silicon

Requires Go 1.21+. You must install and configure dependencies (MySQL, Redis, etcd, Kafka, MinIO, FFmpeg), initialize the database and MinIO, then build and run.

Docker installation

For running the full stack with Docker. No manual data initialization: the dependency stack initializes the database (via mounted SQL) and MinIO buckets (via minio-mc) on first start.

1. Clone

git clone https://github.com/teamgram/teamgram-server.git
cd teamgram-server

2. Start dependency stack

This starts MySQL, Redis, etcd, Kafka, MinIO (and optional monitoring). The database and MinIO buckets are initialized automatically.

docker compose -f docker-compose-env.yaml up -d

3. Start application

docker compose up -d

Logging, monitoring & tracing

Area	Brief	Detailed docs
Log	Filebeat → Kafka (`teamgram-log`) → go-stash → Elasticsearch → Kibana. Config: `teamgramd/deploy/filebeat/conf/filebeat.yml`, `teamgramd/deploy/go-stash/etc/`.	Log collection (中文)
Monitor	Prometheus scrapes metrics; Grafana for dashboards. Enable via `Prometheus` block in `teamgramd/etc2/*.yaml`. Config: `teamgramd/deploy/prometheus/server/prometheus.yml`.	Service monitoring (中文)
Tracing	go-zero Jaeger / Zipkin support. Set `Telemetry` in `teamgramd/etc2/*.yaml`. Jaeger is included in `docker-compose-env.yaml`.	Link tracking (中文)

Compatible clients

Default sign-in verification code: 12345 (change for production.)

Platform	Repository	Patch Link
Android	https://github.com/teamgram/teamgram-android	teamgram-android
iOS	https://github.com/teamgram/teamgram-ios	teamgram-ios
Desktop (TDesktop)	https://github.com/teamgram/teamgram-tdesktop	teamgram-tdesktop

Documentation

Project specs — Architecture, protocol, dependencies, contributing, security, roadmap
Service topology and configuration — Ports, infrastructure, call graph (中文)
CONTRIBUTING · SECURITY · CHANGELOG

Community & feedback

Issues: bugs and feature requests
Telegram: Teamgram group

Enterprise edition

The following are available in the enterprise edition (contact the author):

sticker/theme/chat_theme/wallpaper/reactions/secretchat/2fa/sms/push(apns/web/fcm)/web/scheduled/autodelete/...
channels/megagroups
audio/video/group/conferenceCall
bots
miniapp

See specs/roadmap.md for community vs. enterprise scope.

License

Apache License 2.0.

Give a Star! ⭐

If this project helps you, consider giving it a star.

chat

golang

im-server

messaging

messenger

mtproto

mtproto-server

telegram-server

Project health

Go module

github.com/teamgram/teamgram-server

Latest release

v0.96.0 · Jul 28, 2023

Releases this year

Significant stargazers

felipe stival

152 followers · starred Jul 2019

Alexander Marshalov

54 followers · starred Dec 2022

yjqg6666

27 followers · starred Sep 2022

mmis1000

89 followers · starred Oct 2021

Similar repos

turms-im/turms

🕊️ The world's most advanced open source instant messaging engine for 100K~10M concurrent users…

1,925

tinode/chat

Instant messaging platform. Backend in Go. Clients: Swift iOS, Java Android, JS webapp, scriptable…

13,526

openimsdk/open-im-server

IM Chat OpenClaw

16,688

alberliu/gim

golang写的IM服务器(服务组件形式)

2,711

TangSengDaoDao/TangSengDaoDaoServer

高颜值 IM 即时通讯,聊天

3,614

xelaj/mtproto

🦋 Full-native go implementation of Telegram API

1,352

4q4r/telemt-docker

Secure multi-arch (amd64/arm64) Docker image for Telemt — a fast Rust-based MTProxy (MTProto)…

1,247

ortuman/jackal

💬 Instant messaging server for the Extensible Messaging and Presence Protocol (XMPP).

1,430