Skip to content
Instant messaging server; backend in Go; iOS, Android, web, command line clients; chatbots
Go Python Shell Other
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Ask for more info Jul 13, 2018
chatbot pubm chatbot version Jan 29, 2019
docker push notification instructions updated Jul 20, 2019
docs clarify `thread` header Sep 20, 2019
keygen type in keygen Jul 8, 2019
loadtest build process changes to reflect js changes Aug 12, 2018
pbx server seems to be OK now Jun 13, 2019
py_grpc create python version file if missing Sep 20, 2019
rest-auth more work on changing email and phone # Jun 6, 2019
server Adding mongodb build tag Nov 9, 2019
tinode-db bump database version and provide db upgrade logic Aug 14, 2019
tn-cli small clarification Sep 3, 2019 moving doc files around May 5, 2018
LICENSE github's license selector does not work quite as expected Nov 8, 2017 fix: crash in pbServerCredsDeserialize Aug 22, 2019 migrate webapp from api.. to web.. Aug 22, 2019 simplify detection of pre-release builds Aug 18, 2018 simplify detection of pre-release builds Aug 18, 2018

Tinode Instant Messaging Server

Instant messaging server. Backend in pure Go (license GPL 3.0), client-side binding in Java, Javascript, and Swift, as well as gRPC client support for C++, C#, Go, Java, Node, PHP, Python, Ruby, Objective-C, etc. (license Apache 2.0). Wire transport is JSON over websocket (long polling is also available) for custom bindings, or protobuf with gRPC. Persistent storage RethinkDB and MySQL. A third-party DynamoDB adapter also exists. Other databases can be supported by writing custom adapters.

Tinode is not XMPP/Jabber. It is not compatible with XMPP. It's meant as a replacement for XMPP. On the surface it's a lot like open source WhatsApp or Telegram.

Version 0.16. This is beta-quality software: feature-complete but probably with a few bugs. Follow instructions to install and run. Read API documentation.


The promise of XMPP was to deliver federated instant messaging: anyone would be able to spin up an IM server capable of exchanging messages with any other XMPP server in the world. Unfortunately XMPP never delivered on this promise. Instant messengers are still a bunch of incompatible walled gardens, similar to what AoL of the late 1990s was to the open Internet.

The goal of this project is to actually deliver on XMPP's original vision: create a modern open platform for federated instant messaging with emphasis on mobile communication. A secondary goal is to create a decentralized IM platform which is much harder to track and block by the governments.

Getting support



TinodeWeb, a single page web app, is usually available at (source).

Login as one of alice, bob, carol, dave, frank. Password is <login>123, e.g. login for alice is alice123. You can discover other users by email or phone by prefixing them with email: or tel: respectively. Emails are <login>, e.g., phones are +17025550001 through +17025550009.

If you register a new account you are asked for an email address to send validation code to. For demo purposes you may use 123456 as a universal validation code. The code you get in the email is also valid.

Docker images with the same demo are available.


Tindroid is stable and functional. See screenshots below. A debug APK is provided for convenience.

Command Line

A text-only command line client implements every possible command.


  • The demo server is reset (all data wiped) every night at 3:15am Pacific time. An error message User not found or offline means the server was reset while you were connected. If you see it on the web, reload and relogin. On Android log out and re-login. If the database was changed, delete the app then reinstall.

  • User Tino is a basic chatbot which responds with a random quote to any message.

  • As generally accepted, when you register a new account you are asked for an email address. The server will send an email with a verification code to that address and you can use it to validate the account. To make things easier for testing, the server will also accept 123456 as a verification code. Remove line "debug_response": "123456" from tinode.conf to disable this option.

  • The demo server is configured to use ACME TLS implementation with hard-coded requirement for SNI. If you are unable to connect then the most likely reason is your TLS client's missing support for SNI. Use a different client.

  • The demo uses a single minified javascript bundle and minified css. The un-minified version is available at



  • Android, iOS, web, and command line clients.
  • One-on-one messaging.
  • Group messaging with every member's access permissions managed individually. The maximum number of members is configurable (128 by default).
  • Topic access control with permissions for various actions.
  • Server-generated presence notifications for people, topics.
  • Support for custom authentication backends.
  • Sharded clustering with failover.
  • Persistent message store, paginated message history.
  • Javascript bindings with no external dependencies.
  • Java bindings (dependencies: Jackson, Java-Websocket). Suitable for Android but with no Android SDK dependencies.
  • Websocket, long polling, and gRPC over TCP transports.
  • JSON or protobuf version 3 wire protocols.
  • TLS with Letsencrypt or conventional certificates.
  • User search/discovery.
  • Rich formatting of messages, markdown-style: *style* → style.
  • Inline images and file attachments.
  • Forms and templated responses suitable for chatbots.
  • Message status notifications: message delivery to server; received and read notifications; typing notifications.
  • Support for client-side data caching.
  • Ability to block unwanted communication server-side.
  • Anonymous users (important for use cases related to tech support over chat).
  • Android and web push notifications using FCM.
  • Storage and out of band transfer of large objects like video files using local file system or Amazon S3.
  • Plugins to extend functionality like enabling chat bots.


  • Federation.
  • End to end encryption with OTR for one-on-one messaging and undecided method for group messaging.
  • Group messaging with unlimited number (or hundreds of thousands) of members with bearer token access control.
  • Hot standby.
  • Different levels of message persistence (from strict persistence to "store until delivered" to purely ephemeral messaging).

Third Party Licenses



Android screenshot: list of chats Android screenshot: one conversation


iOS screenshot: list of chats iOS screenshot: one conversation iOS screenshot: account settings

Desktop Web

Desktop web: full app

Mobile Web

Mobile web: contacts Mobile web: chat Mobile web: topic info Mobile web: start new 1:1 chat

SEO Strings

Words 'chat' and 'instant messaging' in Chinese, Russian, Persian and a few other languages.

  • 聊天室 即時通訊
  • чат мессенджер
  • インスタントメッセージ
  • 인스턴트 메신저
  • پیام‌رسانی فوری گپ
  • تراسل فوري
  • Nhắn tin tức thời
  • Mensageiro instantâneo
  • Pesan instan
You can’t perform that action at this time.