{"id":37141747,"url":"https://github.com/sinbad/nakama","last_synced_at":"2026-01-14T16:38:18.479Z","repository":{"id":57591420,"uuid":"124878480","full_name":"sinbad/nakama","owner":"sinbad","description":"Distributed server for social and realtime games and apps.","archived":false,"fork":true,"pushed_at":"2018-03-20T11:38:49.000Z","size":12862,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master-sinbad","last_synced_at":"2024-06-20T01:58:33.493Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://heroiclabs.com","language":"Go","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"heroiclabs/nakama","license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sinbad.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-03-12T11:25:04.000Z","updated_at":"2018-03-14T09:42:56.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/sinbad/nakama","commit_stats":null,"previous_names":[],"tags_count":19,"template":false,"template_full_name":null,"purl":"pkg:github/sinbad/nakama","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sinbad%2Fnakama","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sinbad%2Fnakama/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sinbad%2Fnakama/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sinbad%2Fnakama/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sinbad","download_url":"https://codeload.github.com/sinbad/nakama/tar.gz/refs/heads/master-sinbad","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sinbad%2Fnakama/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28426115,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T16:32:27.303Z","status":"ssl_error","status_checked_at":"2026-01-14T16:28:36.419Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-01-14T16:38:17.598Z","updated_at":"2026-01-14T16:38:18.473Z","avatar_url":"https://github.com/sinbad.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Gitter](https://img.shields.io/gitter/room/heroiclabs/nakama.svg?style=for-the-badge)](https://gitter.im/heroiclabs/nakama)\n[![GitHub release](https://img.shields.io/github/release/heroiclabs/nakama.svg?style=for-the-badge)](https://heroiclabs.com/docs/nakama-download/)\n[![license](https://img.shields.io/github/license/heroiclabs/nakama.svg?style=for-the-badge)](#)\n\n## Nakama\n\n\u003e Distributed server for social and realtime games and apps.\n\n### Features\n\n* **Users** - Register/login new users via social networks, email, or device ID.\n* **Storage** - Store user records, settings, and other objects in collections.\n* **Social** - Users can connect with friends, and join groups. Builtin social graph to see how users can be connected.\n* **Chat** - 1-on-1, group, and global chat between users. Persist messages for chat history.\n* **Multiplayer** - Realtime, or turn-based active and passive multiplayer.\n* **Leaderboards** - Dynamic, seasonal, get top members, or members around a user. Have as many as you need.\n* **Runtime code** - Extend the server with custom logic written in Lua.\n* **Matchmaker**, **dashboard**, **metrics**, etc, etc.\n\nFor more information have a look at the [documentation](https://heroiclabs.com/docs/) and for a quick list of build targets run `make help`.\n\nIf you encounter any issues with the server you can generate diagnostics for us with `nakama doctor`. Send these to support@heroiclabs.com or [open an issue](https://github.com/heroiclabs/nakama/issues).\n\n### Start server\n\nHave a look at our [documentation](https://heroiclabs.com/docs/running-nakama/) for a full introduction on how to run Nakama in development and/or production.\n\nTo start a server locally and bind it to all network interfaces once it's installed and on your path - run `nakama`. The server output will show how it's been configured by default.\n\n```\n$\u003e nakama\n{\"level\":\"info\",\"ts\":\"$$timestamp$$\",\"msg\":\"Node\",\"name\":\"nakama-97f4\",\"version\":\"$$version$$\"}\n{\"level\":\"info\",\"ts\":\"$$timestamp$$\",\"msg\":\"Data directory\",\"path\":\"$$datadir$$\"}\n{\"level\":\"info\",\"ts\":\"$$timestamp$$\",\"msg\":\"Database connections\",\"dsns\":[\"root@localhost:26257\"]}\n{\"level\":\"info\",\"ts\":\"$$timestamp$$\",\"msg\":\"Evaluating modules\",\"count\":0,\"modules\":[]}\n{\"level\":\"info\",\"ts\":\"$$timestamp$$\",\"msg\":\"Dashboard\",\"port\":7351}\n{\"level\":\"info\",\"ts\":\"$$timestamp$$\",\"msg\":\"Dashboard\",\"url\":\"http://127.0.0.1:7351\"}\n{\"level\":\"info\",\"ts\":\"$$timestamp$$\",\"msg\":\"Client\",\"port\":7350}\n```\n\n### Run Nakama with Docker\n\nFollow the [guide](https://heroiclabs.com/docs/install-docker-quickstart/) to run Nakama (and CockroachDB) in Docker.\n\n\u003ca href=\"https://heroiclabs.com/docs/install/docker/\"\u003e\u003cimg src=\"https://upload.wikimedia.org/wikipedia/commons/7/79/Docker_%28container_engine%29_logo.png\" width=\"170\"\u003e\u003c/a\u003e\n\nNakama Docker images are available on [Docker Hub](http://hub.docker.com/r/heroiclabs/nakama/). If you'd like to publish your own Docker image have a look at our [Docker README](https://github.com/heroiclabs/nakama/blob/master/install/docker/README.md).\n\n#### Deploy Nakama with Docker Cloud\n\nNakama can be deployed to any cloud with Docker Cloud such as AWS, Google Cloud, Azure, Digital Ocean or your own private cloud. You'll need to setup Docker Cloud and provision separate nodes for Nakama and CockroachDB.\n\n### Production deployments\n\nNakama server uses cockroachdb as its database server. You're responsible for the [uptime](https://en.wikipedia.org/wiki/Uptime), [replication](https://en.wikipedia.org/wiki/Replication_(computing)), [backups](https://en.wikipedia.org/wiki/Backup), logs, and upgrades of your data.\n\nYou also need to update the Nakama server with every new release and configure the server to auto-scale. If you use our Docker releases follow along with the \"latest\" image tag and check for new releases once a month.\n\n[Using our managed cloud service](https://heroiclabs.com/managed-cloud/) helps save you time, development costs, and eliminates managing your own clusters which is simpler and cheaper as you grow. We recommend our [Managed cloud](https://heroiclabs.com/managed-cloud/) if you're running production games or apps.\n\n### Contribute\n\nTo build the codebase you will need to install these dependencies:\n\n* __go__ The Go compiler toolchain.\n* __nodejs__ A JavaScript runtime.\n* __dep__ A dependency manager for Go projects.\n* __protobuf__ A toolchain used to create custom protocols.\n* __make__ A rule-based build tool (installed by default on most platforms).\n\nYou'll need to setup your Go environment variables like `GOPATH` as usual. You can then install dependent build tools and code:\n\n```\n$\u003e git clone https://github.com/heroiclabs/nakama\n$\u003e cd nakama\n$\u003e make gettools\n$\u003e dep ensure\n```\n\nTo run a Nakama server you'll need to connect it to a database. The system has been specially designed to work with CockroachDB for storage and queries. You can install it on OS X with `brew install cockroach`. For more detailed instructions see their [documentation](https://www.cockroachlabs.com/docs/install-cockroachdb.html).\n\nFor development run:\n\n```\n$\u003e make dbstart nakama\n$\u003e ./build/dev/nakama\n```\n\nTo develop the admin dashboard:\n```\n$\u003e cd dashboard; npm run dev\n```\n\n__NOTE__: The first time you setup the cockroach database you must initialize the schema with `make dbstart dbsetup`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsinbad%2Fnakama","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsinbad%2Fnakama","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsinbad%2Fnakama/lists"}