# \#getting-started

**URL:** https://forum.heroiclabs.com/tag/getting-started/1.md

[Latest](https://forum.heroiclabs.com/latest.md) · [Categories](https://forum.heroiclabs.com/categories.md) · [Tags](https://forum.heroiclabs.com/tags.md)

---

## [Docker Portainer exec /bin/sh: exec format error on raspi5](https://forum.heroiclabs.com/t/docker-portainer-exec-bin-sh-exec-format-error-on-raspi5/6541)

<div class="topic-metadata">

**Author:** [@Moonstone](https://forum.heroiclabs.com/u/Moonstone)\
**Replies:** 3\
**Last updated:** [April 1, 2026, 4:22pm UTC](https://forum.heroiclabs.com/t/docker-portainer-exec-bin-sh-exec-format-error-on-raspi5/6541 "2026-04-01T16:22:57Z")

</div>

Hi, I copied the docker-compose-cockroach.yml in my docker portainer instance on my pi5 and the Logs show me “exec /bin/sh: exec format error” CockroachDB and Prometheus are running fine, only nakama gets the exec er…

---

## [Using modules/esbuild or similar with Typescript](https://forum.heroiclabs.com/t/using-modules-esbuild-or-similar-with-typescript/6439)

<div class="topic-metadata">

**Author:** [@caprica](https://forum.heroiclabs.com/u/caprica)\
**Replies:** 0\
**Last updated:** [October 26, 2025, 11:36pm UTC](https://forum.heroiclabs.com/t/using-modules-esbuild-or-similar-with-typescript/6439 "2025-10-26T23:36:49Z")

</div>

(topic deleted by author)

---

## [Five Unity project to jumpstart your game](https://forum.heroiclabs.com/t/five-unity-project-to-jumpstart-your-game/6437)

<div class="topic-metadata">

**Author:** [@trandromeda](https://forum.heroiclabs.com/u/trandromeda)\
**Replies:** 0\
**Last updated:** [October 25, 2025, 4:51pm UTC](https://forum.heroiclabs.com/t/five-unity-project-to-jumpstart-your-game/6437 "2025-10-25T16:51:49Z")

</div>

Hey everyone! We know many of you come here looking for the quickest path from “hello world” to real-world game features. Today we’ve got something that should make your life a lot easier. We just released five complet…

---

## [Typescript runtine setup, nakama runtime namespace cannot be found by the IDE](https://forum.heroiclabs.com/t/typescript-runtine-setup-nakama-runtime-namespace-cannot-be-found-by-the-ide/5181)

<div class="topic-metadata">

**Author:** [@spartan6nm](https://forum.heroiclabs.com/u/spartan6nm)\
**Replies:** 2\
**Last updated:** [September 30, 2025, 9:11am UTC](https://forum.heroiclabs.com/t/typescript-runtine-setup-nakama-runtime-namespace-cannot-be-found-by-the-ide/5181 "2025-09-30T09:11:15Z")

</div>

after watching the youtube tutorial video of how to setup a nakama runtime typescript project im trying to create a InitModule function but the IDE(vs code) cant find the nakama runtime namespace my code: function Init…

---

## [Unreal 5 Self hosted server](https://forum.heroiclabs.com/t/unreal-5-self-hosted-server/6185)

<div class="topic-metadata">

**Author:** [@VyniosNikolaos](https://forum.heroiclabs.com/u/VyniosNikolaos)\
**Replies:** 3\
**Last updated:** [May 6, 2025, 2:45pm UTC](https://forum.heroiclabs.com/t/unreal-5-self-hosted-server/6185 "2025-05-06T14:45:01Z")

</div>

Hello everyone, I am university student currently writing my Master’s Thesis with the subject “Comparative Analysis of Multiplayer Methods in Unreal Engine 5.4”. The tests will be conducted in typical 5v5 pvp modes. The…

---

## [ResponseError: code: 3, message: json: cannot unmarshal object into Go value of type string](https://forum.heroiclabs.com/t/responseerror-code-3-message-json-cannot-unmarshal-object-into-go-value-of-type-string/6122)

<div class="topic-metadata">

**Author:** [@Sakhile\_Mamba](https://forum.heroiclabs.com/u/Sakhile_Mamba)\
**Replies:** 1\
**Last updated:** [March 27, 2025, 12:40pm UTC](https://forum.heroiclabs.com/t/responseerror-code-3-message-json-cannot-unmarshal-object-into-go-value-of-type-string/6122 "2025-03-27T12:40:19Z")

</div>

I am trying to update the virtual wallet, but I keep getting this error: ResponseError: code: 3, message: json: cannot unmarshal object into Go value of type string Here is the code on my Flutter frontend: // Deposit …

---

## [How to import and export modules in Typescript Runtime](https://forum.heroiclabs.com/t/how-to-import-and-export-modules-in-typescript-runtime/6121)

<div class="topic-metadata">

**Author:** [@Sakhile\_Mamba](https://forum.heroiclabs.com/u/Sakhile_Mamba)\
**Replies:** 1\
**Last updated:** [March 26, 2025, 10:57am UTC](https://forum.heroiclabs.com/t/how-to-import-and-export-modules-in-typescript-runtime/6121 "2025-03-26T10:57:48Z")

</div>

Hello, I am trying to import a TypeScript module into my main.ts file, but I am having trouble. Setting “module” to “System” or “AMD” in the tsconfig file does not work. Please help. Below is my tsconfig file code: { …

---

## [Reporting Unhealthy](https://forum.heroiclabs.com/t/reporting-unhealthy/6084)

<div class="topic-metadata">

**Author:** [@Velaseriat](https://forum.heroiclabs.com/u/Velaseriat)\
**Replies:** 1\
**Last updated:** [March 17, 2025, 1:32pm UTC](https://forum.heroiclabs.com/t/reporting-unhealthy/6084 "2025-03-17T13:32:58Z")

</div>

Hi, How do I handle health checks? It keep reporting unhealthy, and I tried seeing several reporting healthpoints and it wasn’t working. I did not do the typical postgres-nakama Docker setup as I already had a postgres…

---

## [Support for Microsoft SQL Server?](https://forum.heroiclabs.com/t/support-for-microsoft-sql-server/5941)

<div class="topic-metadata">

**Author:** [@kburgin](https://forum.heroiclabs.com/u/kburgin)\
**Replies:** 3\
**Last updated:** [January 22, 2025, 4:26pm UTC](https://forum.heroiclabs.com/t/support-for-microsoft-sql-server/5941 "2025-01-22T16:26:55Z")

</div>

We are looking to deploy Nakama Server but need to harness our existing MSSQL Server infrastructure. I can see the documentation mentions unofficial PostgreSQL Server support and some other mentions of using the pgx libr…

---

## [Cannot start Nakama with config from postgres guideline](https://forum.heroiclabs.com/t/cannot-start-nakama-with-config-from-postgres-guideline/5965)

<div class="topic-metadata">

**Author:** [@lolerji](https://forum.heroiclabs.com/u/lolerji)\
**Replies:** 1\
**Last updated:** [January 22, 2025, 8:18am UTC](https://forum.heroiclabs.com/t/cannot-start-nakama-with-config-from-postgres-guideline/5965 "2025-01-22T08:18:56Z")

</div>

I have been trying to setup Nakama with the sample configuration from github. I successfully started a previous server using that configuration but couldn’t add custom config so I tried to start from scratch. Then I star…

---

## [Resolving JSON Parsing Errors in Nakama Custom Authentication Introduction](https://forum.heroiclabs.com/t/resolving-json-parsing-errors-in-nakama-custom-authentication-introduction/5871)

<div class="topic-metadata">

**Author:** [@mahanshAdtiya](https://forum.heroiclabs.com/u/mahanshAdtiya)\
**Replies:** 1\
**Last updated:** [January 7, 2025, 11:39am UTC](https://forum.heroiclabs.com/t/resolving-json-parsing-errors-in-nakama-custom-authentication-introduction/5871 "2025-01-07T11:39:17Z")

</div>

The Problem The Nakama client sends a request to the server to authenticate a user. The server responds with a JWT token, but the Nakama client throws a parsing error. The error indicates that the response from the serv…

---

## [Nakama for 3D FPS Games: Lag Compensation, Prediction, Headless server mode](https://forum.heroiclabs.com/t/nakama-for-3d-fps-games-lag-compensation-prediction-headless-server-mode/5883)

<div class="topic-metadata">

**Author:** [@bigbyte](https://forum.heroiclabs.com/u/bigbyte)\
**Replies:** 1\
**Last updated:** [December 23, 2024, 12:29pm UTC](https://forum.heroiclabs.com/t/nakama-for-3d-fps-games-lag-compensation-prediction-headless-server-mode/5883 "2024-12-23T12:29:26Z")

</div>

Hi, Is Nakama suitable for creating a large 3D FPS game? I plan to use Unity3D as the client. Does Nakama provide built-in lag compensation and prediction? Is there support for syncing Mecanim animations? Additional…

---

## [Modify data of multiple, if not all, players](https://forum.heroiclabs.com/t/modify-data-of-multiple-if-not-all-players/5847)

<div class="topic-metadata">

**Author:** [@tricko.ttg](https://forum.heroiclabs.com/u/tricko.ttg)\
**Replies:** 4\
**Last updated:** [December 11, 2024, 12:03am UTC](https://forum.heroiclabs.com/t/modify-data-of-multiple-if-not-all-players/5847 "2024-12-11T00:03:13Z")

</div>

Just wondering for the long run, is there an api to modify multiple or all player data like a batch request? Since there are leaderboards rewarding, I assume there’s a way to send rewards to multiple players. If so, is…

---

## [Leaderboard prev cursor](https://forum.heroiclabs.com/t/leaderboard-prev-cursor/5845)

<div class="topic-metadata">

**Author:** [@omerfarukkvk](https://forum.heroiclabs.com/u/omerfarukkvk)\
**Replies:** 3\
**Last updated:** [December 3, 2024, 11:31am UTC](https://forum.heroiclabs.com/t/leaderboard-prev-cursor/5845 "2024-12-03T11:31:11Z")

</div>

Hello, I am currently dealing with the leaderboard and I noticed something about the prev cursor. While there is no problem with the record list that I first call with the prev cursor, when I call the 2nd call, the sort…

---

## [What is best practice for managing boardgame move commands in Nakama? RPC or send\_match\_state\_asyc() or something else?](https://forum.heroiclabs.com/t/what-is-best-practice-for-managing-boardgame-move-commands-in-nakama-rpc-or-send-match-state-asyc-or-something-else/5772)

<div class="topic-metadata">

**Author:** [@MattW](https://forum.heroiclabs.com/u/MattW)\
**Replies:** 4\
**Last updated:** [November 6, 2024, 6:50pm UTC](https://forum.heroiclabs.com/t/what-is-best-practice-for-managing-boardgame-move-commands-in-nakama-rpc-or-send-match-state-asyc-or-something-else/5772 "2024-11-06T18:50:49Z")

</div>

Hello Heroic Labs! I am making a turn-based boardgame and would appreciate advice on best Nakama practices. The active player should be able to make the moves that comprise their turn, issuing at most one move command…

---

## [Static/default matches](https://forum.heroiclabs.com/t/static-default-matches/2418)

<div class="topic-metadata">

**Author:** [@mautoan11](https://forum.heroiclabs.com/u/mautoan11)\
**Replies:** 17\
**Last updated:** [October 28, 2024, 3:15pm UTC](https://forum.heroiclabs.com/t/static-default-matches/2418 "2024-10-28T15:15:00Z")

</div>

Hi, How can I let the server automatically create several authoritative matches when it initiates? Thank you,

---

## [Inquiry about heroic cloud](https://forum.heroiclabs.com/t/inquiry-about-heroic-cloud/5730)

<div class="topic-metadata">

**Author:** [@Gandangf](https://forum.heroiclabs.com/u/Gandangf)\
**Replies:** 3\
**Last updated:** [October 24, 2024, 9:13am UTC](https://forum.heroiclabs.com/t/inquiry-about-heroic-cloud/5730 "2024-10-24T09:13:30Z")

</div>

Inquiries about heroic cloud Hello friends We are a development team developing an indie game. I wrote a post before, but we used EC2 to use your service locally, but there were some problems, so we are trying to use …

---

## [Can't change default login and password for Nakama Console](https://forum.heroiclabs.com/t/cant-change-default-login-and-password-for-nakama-console/3094)

<div class="topic-metadata">

**Author:** [@Noizless](https://forum.heroiclabs.com/u/Noizless)\
**Replies:** 4\
**Last updated:** [October 17, 2024, 1:37pm UTC](https://forum.heroiclabs.com/t/cant-change-default-login-and-password-for-nakama-console/3094 "2024-10-17T13:37:05Z")

</div>

Versions: Nakama {3.13.1+2000e4b8}, {Docker Compose} Hello everyone. I’m the new one of Nakama user. My Nakama Server is working. I could connect to the Nakama Console but I couldn’t change default login and password fo…

---

## [Require example of logging in from a unity server to nakama](https://forum.heroiclabs.com/t/require-example-of-logging-in-from-a-unity-server-to-nakama/5651)

<div class="topic-metadata">

**Author:** [@jell-o-fishi](https://forum.heroiclabs.com/u/jell-o-fishi)\
**Replies:** 3\
**Last updated:** [September 18, 2024, 4:49pm UTC](https://forum.heroiclabs.com/t/require-example-of-logging-in-from-a-unity-server-to-nakama/5651 "2024-09-18T16:49:53Z")

</div>

I manage to login from the unity client to nakama with AuthenticateDeviceAsync. Currently i am using the same authentication method from the server. The documentation states that server logins will not have a user ID, …

---

## [UpdateAccount not change Presence username](https://forum.heroiclabs.com/t/updateaccount-not-change-presence-username/5649)

<div class="topic-metadata">

**Author:** [@hexun80149128](https://forum.heroiclabs.com/u/hexun80149128)\
**Replies:** 2\
**Last updated:** [September 18, 2024, 10:51am UTC](https://forum.heroiclabs.com/t/updateaccount-not-change-presence-username/5649 "2024-09-18T10:51:17Z")

</div>

when client called UpdateAccount to change the username.I found that UserPresence username not change .only client relogin ? Or there is any other way?thanks.

---

## [Error when starting Nakama in docker](https://forum.heroiclabs.com/t/error-when-starting-nakama-in-docker/5634)

<div class="topic-metadata">

**Author:** [@simbafs](https://forum.heroiclabs.com/u/simbafs)\
**Replies:** 1\
**Last updated:** [September 16, 2024, 7:58am UTC](https://forum.heroiclabs.com/t/error-when-starting-nakama-in-docker/5634 "2024-09-16T07:58:31Z")

</div>

I follow the steps in Docker Compose - Heroic Labs Documentation to run nakama in docker and get an error Failed to extract ServerMetadata from context when access to http://127.0.0.1:7350/. It is my docker-compose.yml …

---

## [Load one specific Level per Match](https://forum.heroiclabs.com/t/load-one-specific-level-per-match/5599)

<div class="topic-metadata">

**Author:** [@CiscoStu](https://forum.heroiclabs.com/u/CiscoStu)\
**Replies:** 4\
**Last updated:** [September 6, 2024, 1:57pm UTC](https://forum.heroiclabs.com/t/load-one-specific-level-per-match/5599 "2024-09-06T13:57:24Z")

</div>

Hello, I’m looking to create an MMO-ish game, and one of my current questions is how to handle transitions between “maps.” For context, this will be a 2D platformer game, where each level acts as a separate piece. Using…

---

## [How to view logs](https://forum.heroiclabs.com/t/how-to-view-logs/5466)

<div class="topic-metadata">

**Author:** [@hxw956631920](https://forum.heroiclabs.com/u/hxw956631920)\
**Replies:** 2\
**Last updated:** [July 10, 2024, 3:23pm UTC](https://forum.heroiclabs.com/t/how-to-view-logs/5466 "2024-07-10T15:23:07Z")

</div>

How can i view the logs in console ui

---

## [Issues with RPCs in Lua](https://forum.heroiclabs.com/t/issues-with-rpcs-in-lua/5415)

<div class="topic-metadata">

**Author:** [@Bonepixel](https://forum.heroiclabs.com/u/Bonepixel)\
**Replies:** 2\
**Last updated:** [July 4, 2024, 5:04am UTC](https://forum.heroiclabs.com/t/issues-with-rpcs-in-lua/5415 "2024-07-04T05:04:27Z")

</div>

It appears that my RPCs aren’t sending data to the server no sure why please help. :joy: function M.custom\_rpc\_test() local payload = { item = "cowboy" } local body = json.encode(payload) pprint("Encoded JSON Bo…

---

## [Nakama docker-compose fails with "compose file is invalid; services.nakama.depends\_on contains an invalid type"](https://forum.heroiclabs.com/t/nakama-docker-compose-fails-with-compose-file-is-invalid-services-nakama-depends-on-contains-an-invalid-type/5148)

<div class="topic-metadata">

**Author:** [@unfa](https://forum.heroiclabs.com/u/unfa)\
**Replies:** 3\
**Last updated:** [May 24, 2024, 1:01pm UTC](https://forum.heroiclabs.com/t/nakama-docker-compose-fails-with-compose-file-is-invalid-services-nakama-depends-on-contains-an-invalid-type/5148 "2024-05-24T13:01:14Z")

</div>

Hi! I’m trying to install Nakama on a Debian-based Linode VPS. The system is 4.19.0-26-amd64 #1 SMP Debian 4.19.304-1 (2024-01-09) x86\_64 GNU/Linux. Docker version 18.09.1, build 4c52b90 docker-compose version 1.21.…

---

## [How to create an authoritative match using defold sdk?](https://forum.heroiclabs.com/t/how-to-create-an-authoritative-match-using-defold-sdk/5168)

<div class="topic-metadata">

**Author:** [@ropoko](https://forum.heroiclabs.com/u/ropoko)\
**Replies:** 8\
**Last updated:** [April 18, 2024, 6:05pm UTC](https://forum.heroiclabs.com/t/how-to-create-an-authoritative-match-using-defold-sdk/5168 "2024-04-18T18:05:31Z")

</div>

Hey! I’m trying to create an authoritative match, but I’m not sure how to do that using defold sdk. When I search on the github the term “authoritative”, it only shows the option to list\_matches, but that it’s not what…

---

## [Restore Session in Dart using AuthToken or a String key?](https://forum.heroiclabs.com/t/restore-session-in-dart-using-authtoken-or-a-string-key/5139)

<div class="topic-metadata">

**Author:** [@Shuin](https://forum.heroiclabs.com/u/Shuin)\
**Replies:** 2\
**Last updated:** [April 5, 2024, 6:29pm UTC](https://forum.heroiclabs.com/t/restore-session-in-dart-using-authtoken-or-a-string-key/5139 "2024-04-05T18:29:47Z")

</div>

In Unity sample you can restore session by saving its authToken and retrieve it via prefs because it is a string like on the fish game example. var authToken = PlayerPrefs.GetString(SessionPrefName); if (!…

---

## [Default tickRate in Non-Authorative Match](https://forum.heroiclabs.com/t/default-tickrate-in-non-authorative-match/5143)

<div class="topic-metadata">

**Author:** [@Shuin](https://forum.heroiclabs.com/u/Shuin)\
**Replies:** 1\
**Last updated:** [April 4, 2024, 3:27pm UTC](https://forum.heroiclabs.com/t/default-tickrate-in-non-authorative-match/5143 "2024-04-04T15:27:57Z")

</div>

Hi just curious, what is the default tickRate in a non-authorative match? I just want to know to have a baseline or comparison when trying to test a tickrate in an authorative match.

---

## [6 characters Room ID](https://forum.heroiclabs.com/t/6-characters-room-id/5110)

<div class="topic-metadata">

**Author:** [@Shuin](https://forum.heroiclabs.com/u/Shuin)\
**Replies:** 2\
**Last updated:** [April 3, 2024, 10:56am UTC](https://forum.heroiclabs.com/t/6-characters-room-id/5110 "2024-04-03T10:56:13Z")

</div>

Just a simple question, is it safe use the first 6 character of the matchID as a Room ID since I think it is an uuid which I assume that having collision with same id would be a rare case? I’m aware that the shorter the …

---

## [About using goland debugger](https://forum.heroiclabs.com/t/about-using-goland-debugger/4909)

<div class="topic-metadata">

**Author:** [@BOFA1ex](https://forum.heroiclabs.com/u/BOFA1ex)\
**Replies:** 3\
**Last updated:** [April 3, 2024, 6:00am UTC](https://forum.heroiclabs.com/t/about-using-goland-debugger/4909 "2024-04-03T06:00:11Z")

</div>

With some minor modifications to the directions in Debugging with Delve guide, and then debug your custom Go server runtime code using Delve inside a Docker container via Goland. Diff than Using VSCode Debugger - Hero…

[Next page](https://forum.heroiclabs.com/tag/getting-started/1.md?match_all_tags=true&page=1&tags%5B%5D=getting-started)
