Skip to content
Switch branches/tags
This branch is 2917 commits behind tinode:master.

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Tinode Instant Messaging Server

Instant messaging server. Backend in pure Go (Affero GPL 3.0), client-side binding in Java for Android and Javascript (Apache 2.0), persistent storage RethinkDB, JSON over websocket (long polling is also available). No UI components other than demo apps. Tinode is meant as a replacement for XMPP.

Version 0.7. This is alpha-quality software. Bugs should be expected. Follow instructions to install and run. Read API documentation.

A javascript demo 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. Android demo is mostly stable and functional. See screenshots below.


XMPP is a mature specification with support for a very broad spectrum of use cases developed long before mobile became important. As a result most (all?) known XMPP servers are difficult to adapt for the most common use case of a few people messaging each other from mobile devices. Tinode is an attempt to build a modern replacement for XMPP/Jabber focused on a narrow use case of instant messaging between humans with emphasis on mobile communication.



  • One-on-one messaging.
  • Groups (topics) with up to 16 members where every member's access permissions are managed individually.
  • Topic access control with permissions for various actions.
  • Server-generated presence notifications for people, topics.
  • Basic sharded clustering.
  • Persistent message store, paginated message history.
  • Javascript bindings with no dependencies.
  • Android Java bindings (dependencies: jackson, nv-websocket-client)
  • Websocket transport.
  • JSON wire protocol.
  • User search/discovery.
  • Message delivery status: server-generated delivery to server, client-generated received and read notifications; typing notifications.
  • Basic support for client-side message caching.
  • Ability to block unwanted communication server-side.
  • Compile-time custom authentication support.


  • iOS client bindings.
  • Mobile push notification hooks.
  • Support for long polling (currently exists but broken).
  • Groups (topics) with unlimited number of members with bearer token access control.
  • Failover/hot standby/replication.
  • Federation.
  • Different levels of message persistence (from strict persistence to store until delivered to purely ephemeral messaging).
  • Support for binary wire protocol.
  • Anonymous users.
  • Support for other SQL and NoSQL backends.
  • Plugins.



javascript app screenshot


javascript app screenshot

javascript app screenshot


Instant messaging server - backend in Go, client-side binding in Java and Javascript



No releases published


No packages published