selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Nakama logo

Self-host Nakama

v3.42.0

Open-source game backend for multiplayer and social games

ReleaseOpen SourceApache-2.0
Updated4 days ago
LanguageGo
Setup difficultyModerate
Stars
13 685
Ports
7350 (HTTP/JSON API server), 7351 (Embedded developer console (HTTP)), 7349 (gRPC API server), 7348 (gRPC API server for the embedded console)
Requires
CockroachDB
Docker
heroiclabs/nakama
Install with Docker Compose
Console dashboard with real-time per-node metrics: latency, RPC rate, inbound and outbound bandwidthConsole players list with user IDs, usernames and creation timestampsConsole storage page: searchable table of storage objects with permissionsConsole API explorer for testing endpoints and custom RPCs

What is Nakama?

Nakama is an open-source backend server for online and social games, aimed at developers who want to own their multiplayer infrastructure instead of building one from scratch. It ships with user accounts and social sign-in, friends and groups, persistent chat, realtime plus turn-based gameplay with matchmaking, leaderboards, tournaments, parties, a data storage engine, validation of purchases and subscriptions, notifications, and custom server logic written in Go, Lua, or TypeScript/JavaScript. An embedded web console lets teams inspect stored data, monitor service metrics, manage players, and test APIs without a separate installation. The server exposes gRPC, HTTP/JSON, WebSockets, and rUDP APIs and requires CockroachDB or another Postgres-wire-compatible database. To self-host it you either run the provided docker-compose quickstart or download native binaries and execute the migrate and start commands; the deployment notes suggest provisioning separate nodes for the server and the database. Nakama is Apache-2.0 licensed, and Heroic Labs also sells a managed deployment service (Heroic Cloud) alongside an enterprise edition.

Nakama alternatives

Should you self-host Nakama?

Nakama scores 76/100 on selfhost.directory (how scoring works) and ranks #3 of 62 in Game Servers. It has 13 685 GitHub stars, +143 in the last 30 days.

It shipped 10 stable releases in the past year. The latest, v3.42.0, came out on 3 November 2026. New versions land roughly every 5 weeks.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is Apache-2.0-licensed and written mostly in Go.

Its closest alternative on selfhost.directory is minecraft (78/100, 14 524 stars). It scores higher overall, so compare the two before you pick. See Nakama vs minecraft side by side.

Features

  • Chat
  • Data storage engine
  • Friends and groups
  • In-app notifications
  • In-app purchase validation
  • Leaderboards
  • Matchmaking
  • Multi-protocol API
  • Parties
  • Realtime and turn-based multiplayer
  • Server-side runtime code
  • Social and email/device authentication
  • Tournaments
  • Web-based admin console

Nakama README

Nakama - Distributed server for social and realtime games and apps

Version Downloads License Nakama Forum Nakama Documentation

Features

How to install Nakama

Install Nakama with Docker Compose

CockroachDB or another Postgres wire-compatible server as database

The fastest way to run the server and the database is with Docker. Setup Docker and start the daemon.

  1. Set up a docker-compose file and place it in a folder for your project.

  2. Run docker-compose -f ./docker-compose.yml up to download container images and run the servers.

Images on Docker Hub and registry.heroiclabs.com.

How to configure Nakama

  • nameNakama node name (must be unique) - It will default to nakama. This name is also used in the log files.
  • data_dirAn absolute path to a writeable folder where Nakama will store its data, including logs. Default value is the working directory that Nakama was started on.
  • shutdown_grace_secMaximum number of seconds to wait for the server to complete work before shutting down. If 0 the server will shut down immediately when it receives a termination signal. Default value is 0.
  • cluster.gossip_bindaddrInterface address to bind Nakama to for discovery. By default listening on all interfaces.
  • cluster.gossip_bindportPort number to bind Nakama to for discovery. Default value is 7352.

Nakama releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

More in Game Servers

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…