# Local Setup **URL:** https://forum.heroiclabs.com/c/help/10.md [Latest](https://forum.heroiclabs.com/latest.md) · [Categories](https://forum.heroiclabs.com/categories.md) · [Tags](https://forum.heroiclabs.com/tags.md) --- ## [Nakama Lua Intellisense Implementation](https://forum.heroiclabs.com/t/nakama-lua-intellisense-implementation/2576)
**Author:** [@KittySkin](https://forum.heroiclabs.com/u/KittySkin)\ **Replies:** 7\ **Last updated:** [January 14, 2025, 5:21am UTC](https://forum.heroiclabs.com/t/nakama-lua-intellisense-implementation/2576 "2025-01-14T05:21:53Z")
Hello! This is a bit of a repost, but since I didn’t create the original topic related to the Intellisense Implementation for Lua, I decided to do this and make it better sorted and easier to read. Without further ado, … --- ## [About the Local Setup category](https://forum.heroiclabs.com/t/about-the-local-setup-category/1133)
**Author:** [@erlend\_sh](https://forum.heroiclabs.com/u/erlend_sh)\ **Replies:** 0
Get help installing, upgrading, configuring and debugging your local development Nakama setup. Please email us for deployment and scaling support. --- ## [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)
**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")
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… --- ## [Bandwidth usage questions and/or discrepency](https://forum.heroiclabs.com/t/bandwidth-usage-questions-and-or-discrepency/6527)
**Author:** [@nabeel](https://forum.heroiclabs.com/u/nabeel)\ **Replies:** 10\ **Last updated:** [March 28, 2026, 10:51pm UTC](https://forum.heroiclabs.com/t/bandwidth-usage-questions-and-or-discrepency/6527 "2026-03-28T22:51:30Z")
Hi, I have a relatively small Nakama instance, which is just exchanging presented. At the moment, I have 12 sessions, 34 presences. No custom scripts - only some post-authentication which creates groups and assigns user… --- ## [How to increase the 32 player limit for Nakama realtime matches?](https://forum.heroiclabs.com/t/how-to-increase-the-32-player-limit-for-nakama-realtime-matches/6499)
**Author:** [@MarzIIperator](https://forum.heroiclabs.com/u/MarzIIperator)\ **Replies:** 1\ **Last updated:** [January 21, 2026, 11:51am UTC](https://forum.heroiclabs.com/t/how-to-increase-the-32-player-limit-for-nakama-realtime-matches/6499 "2026-01-21T11:51:49Z")
Hey! I am developing a multiplayer game using Nakama and have run into the hard limit of 32 players per realtime match. I need to support more than 32 concurrent players in a single match/session. I am using Playwright… --- ## [Nakama with async](https://forum.heroiclabs.com/t/nakama-with-async/6485)
**Author:** [@developerdinno](https://forum.heroiclabs.com/u/developerdinno)\ **Replies:** 1\ **Last updated:** [January 7, 2026, 5:38pm UTC](https://forum.heroiclabs.com/t/nakama-with-async/6485 "2026-01-07T17:38:51Z")
How i handle the async await into the nakama im not figureout that --- ## [Nakama automatically disconnect the database connection](https://forum.heroiclabs.com/t/nakama-automatically-disconnect-the-database-connection/6484)
**Author:** [@developerdinno](https://forum.heroiclabs.com/u/developerdinno)\ **Replies:** 1\ **Last updated:** [January 7, 2026, 5:36pm UTC](https://forum.heroiclabs.com/t/nakama-automatically-disconnect-the-database-connection/6484 "2026-01-07T17:36:54Z")
Here i have a database in the EC2 instance. Sometimes the automatic database is disconnected {“level”:“error”,“ts”:“2026-01-07T03:49:25.824Z”,“caller”:“server/core\_account.go:91”,“msg”:“Error retrieving user account.”,“… --- ## [Authenticate device is ignoring username field on https?](https://forum.heroiclabs.com/t/authenticate-device-is-ignoring-username-field-on-https/6400)
**Author:** [@crowie](https://forum.heroiclabs.com/u/crowie)\ **Replies:** 9\ **Last updated:** [October 31, 2025, 10:53am UTC](https://forum.heroiclabs.com/t/authenticate-device-is-ignoring-username-field-on-https/6400 "2025-10-31T10:53:12Z")
Hello, When running on a http server and creating a new user with AuthenticateDeviceAsync and the username field, it works normally. When running on https server with the same parameters, it seems to ignore the username… --- ## [Five Unity project to jumpstart your game](https://forum.heroiclabs.com/t/five-unity-project-to-jumpstart-your-game/6437)
**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")
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… --- ## [Building go modules to use with test setup on RPI](https://forum.heroiclabs.com/t/building-go-modules-to-use-with-test-setup-on-rpi/6404)
**Author:** [@ilkeraktuna](https://forum.heroiclabs.com/u/ilkeraktuna)\ **Replies:** 13\ **Last updated:** [September 18, 2025, 5:17pm UTC](https://forum.heroiclabs.com/t/building-go-modules-to-use-with-test-setup-on-rpi/6404 "2025-09-18T17:17:30Z")
I am running a test server on raspberry pi. The architecture is arm64 so I use the 3.31.0 version of Nakama. It works fine for my tests. However, now I want to build and use modules written in GO, so I installed Go 1.25.… --- ## [Connect to client without port](https://forum.heroiclabs.com/t/connect-to-client-without-port/6398)
**Author:** [@crowie](https://forum.heroiclabs.com/u/crowie)\ **Replies:** 1\ **Last updated:** [September 9, 2025, 7:53am UTC](https://forum.heroiclabs.com/t/connect-to-client-without-port/6398 "2025-09-09T07:53:36Z")
Hello, Is there a way to connect to a host without adding a port using nakama’s default setup? This includes using a scheme, serverkey and adapter --- ## [Matchmaking never found each other using Nakama SDK Unity](https://forum.heroiclabs.com/t/matchmaking-never-found-each-other-using-nakama-sdk-unity/6396)
**Author:** [@gesekanmagnet](https://forum.heroiclabs.com/u/gesekanmagnet)\ **Replies:** 1\ **Last updated:** [September 8, 2025, 9:37am UTC](https://forum.heroiclabs.com/t/matchmaking-never-found-each-other-using-nakama-sdk-unity/6396 "2025-09-08T09:37:20Z")
I try to create a match with matchmaker following this tutorial: https://youtu.be/-ZpmZo6ZvIo Tickets are created on both client, matchmaker set with minCount: 2 and maxCount: 2, with default query, but they have never … --- ## [Config not taking effect and not showing in console](https://forum.heroiclabs.com/t/config-not-taking-effect-and-not-showing-in-console/6394)
**Author:** [@Alx](https://forum.heroiclabs.com/u/Alx)\ **Replies:** 1\ **Last updated:** [September 7, 2025, 3:51am UTC](https://forum.heroiclabs.com/t/config-not-taking-effect-and-not-showing-in-console/6394 "2025-09-07T03:51:58Z")
1- I followed the docker setup: Docker Compose - Heroic Labs Documentation it says: You must edit the nakama:volumes: entry in your docker-compose.yml file so that it looks like the following: /c/Users/\/projec… --- ## [IAP refund case for iso and android](https://forum.heroiclabs.com/t/iap-refund-case-for-iso-and-android/6388)
**Author:** [@developerdinno](https://forum.heroiclabs.com/u/developerdinno)\ **Replies:** 1\ **Last updated:** [August 25, 2025, 10:53am UTC](https://forum.heroiclabs.com/t/iap-refund-case-for-iso-and-android/6388 "2025-08-25T10:53:42Z")
Here I want to add the IAP refund case for iOS and Android. Is there any suggestion about this flow? Please suggest and guide me on how I should implement it. --- ## [Feature request: Add items to storage from console UI](https://forum.heroiclabs.com/t/feature-request-add-items-to-storage-from-console-ui/6360)
**Author:** [@jonbonazza](https://forum.heroiclabs.com/u/jonbonazza)\ **Replies:** 2\ **Last updated:** [August 7, 2025, 7:42pm UTC](https://forum.heroiclabs.com/t/feature-request-add-items-to-storage-from-console-ui/6360 "2025-08-07T19:42:39Z")
In the Nakama console, there doesn’t seem to be a way to directly insert new entries into storage. This is handy during development when some features in the game arent implemented yet and you want to mock some data for … --- ## [IAP validation in IOS](https://forum.heroiclabs.com/t/iap-validation-in-ios/6369)
**Author:** [@developerdinno](https://forum.heroiclabs.com/u/developerdinno)\ **Replies:** 3\ **Last updated:** [August 7, 2025, 9:53am UTC](https://forum.heroiclabs.com/t/iap-validation-in-ios/6369 "2025-08-07T09:53:44Z")
I’m trying to validate Purchase Apple nakama.purchaseValidateApple(player.userId, receiptPayload, true); here receiptpaylad have old transaction too how i get the latest since it give always seen before true. so how h… --- ## [One Nakama Instance many games](https://forum.heroiclabs.com/t/one-nakama-instance-many-games/6335)
**Author:** [@MightyPossum](https://forum.heroiclabs.com/u/MightyPossum)\ **Replies:** 1\ **Last updated:** [July 30, 2025, 10:08am UTC](https://forum.heroiclabs.com/t/one-nakama-instance-many-games/6335 "2025-07-30T10:08:17Z")
I am planning our studios Nakama server setup (just on-prem for now) And we want some shared accounts, and possibly some shared data between our games. It’s mostly server authoritative games, with no real-time multipla… --- ## [Nk.register\_rpc in lua does not accept PUT requests and returns an error {"code":12,"message":"Method Not Allowed"} is there a way to make the server accept PUT requests?](https://forum.heroiclabs.com/t/nk-register-rpc-in-lua-does-not-accept-put-requests-and-returns-an-error-code-12-message-method-not-allowed-is-there-a-way-to-make-the-server-accept-put-requests/6349)
**Author:** [@gamemania1000000](https://forum.heroiclabs.com/u/gamemania1000000)\ **Replies:** 3\ **Last updated:** [July 29, 2025, 5:27pm UTC](https://forum.heroiclabs.com/t/nk-register-rpc-in-lua-does-not-accept-put-requests-and-returns-an-error-code-12-message-method-not-allowed-is-there-a-way-to-make-the-server-accept-put-requests/6349 "2025-07-29T17:27:55Z")
Hello! I am implementing a shopping cart system which consists of two steps: 1) Create a payment by sending a POST request to the Nakama server. 2) Complete the payment by sending a PUT request. I have a problem: I found… --- ## [When I make a request through a proxy, nakama writes an error "error": "HTTP key invalid" although the key is passed in the parameters, what's wrong?](https://forum.heroiclabs.com/t/when-i-make-a-request-through-a-proxy-nakama-writes-an-error-error-http-key-invalid-although-the-key-is-passed-in-the-parameters-whats-wrong/6346)
**Author:** [@gamemania1000000](https://forum.heroiclabs.com/u/gamemania1000000)\ **Replies:** 1\ **Last updated:** [July 29, 2025, 3:47pm UTC](https://forum.heroiclabs.com/t/when-i-make-a-request-through-a-proxy-nakama-writes-an-error-error-http-key-invalid-although-the-key-is-passed-in-the-parameters-whats-wrong/6346 "2025-07-29T15:47:00Z")
I have a problem, I make a direct request of this type - curl -X POST “http://2.97.101.15:7350/v2/rpc/custom\_payment?http\_key=mysecretkey&unwrap=true&titleId=my-game&gameType=pc&userId=2000009190&paymentId=029481-100000… --- ## [Vscode remote debugging issues](https://forum.heroiclabs.com/t/vscode-remote-debugging-issues/6321)
**Author:** [@EpicLee](https://forum.heroiclabs.com/u/EpicLee)\ **Replies:** 0\ **Last updated:** [July 18, 2025, 9:05am UTC](https://forum.heroiclabs.com/t/vscode-remote-debugging-issues/6321 "2025-07-18T09:05:06Z")
I according to the Using VSCode Debugger - Heroic Labs Documentation I configured the debugging method of vscode, but still couldn’t break the point successfully. Could someone update the configuration method of launch.… --- ## [IOS Facebook Auth or link](https://forum.heroiclabs.com/t/ios-facebook-auth-or-link/6319)
**Author:** [@developerdinno](https://forum.heroiclabs.com/u/developerdinno)\ **Replies:** 2\ **Last updated:** [July 17, 2025, 8:21am UTC](https://forum.heroiclabs.com/t/ios-facebook-auth-or-link/6319 "2025-07-17T08:21:01Z")
Here im trying to implement Facebook auth or link into the iOS. Invalid: Oauth access token - Cannot parse access token ...... Here im using unity SDK FB 17.0 and FROM registry.heroiclabs.com/heroiclabs/nakama:3.27.1 … --- ## [Google IAP with validation hook in TS](https://forum.heroiclabs.com/t/google-iap-with-validation-hook-in-ts/6283)
**Author:** [@developerdinno](https://forum.heroiclabs.com/u/developerdinno)\ **Replies:** 9\ **Last updated:** [July 16, 2025, 1:15pm UTC](https://forum.heroiclabs.com/t/google-iap-with-validation-hook-in-ts/6283 "2025-07-16T13:15:18Z")
Here i using the registerAfterValidatePurchaseGoogle hook export const afterGooglePurchase: nkruntime.AfterHookFunction\ = async (ctx, logger, … --- ## [Getting error=Post "": unsupported protocol scheme "" with Google Authentication](https://forum.heroiclabs.com/t/getting-error-post-unsupported-protocol-scheme-with-google-authentication/6316)
**Author:** [@zee-imaginationai](https://forum.heroiclabs.com/u/zee-imaginationai)\ **Replies:** 9\ **Last updated:** [July 15, 2025, 11:35am UTC](https://forum.heroiclabs.com/t/getting-error-post-unsupported-protocol-scheme-with-google-authentication/6316 "2025-07-15T11:35:48Z")
Hi I am trying to Authenticate Nakama with Google using Google Play Games Service in Unity. I have setup Google Cloud OAuth (tried oauth in OAuth Playground and it is working correctly) but when I try to authenticate in-… --- ## [Unity SendMatchStateAsync - Authoritative + Presences on server side?](https://forum.heroiclabs.com/t/unity-sendmatchstateasync-authoritative-presences-on-server-side/825)
**Author:** [@louis030195](https://forum.heroiclabs.com/u/louis030195)\ **Replies:** 5\ **Last updated:** [June 22, 2025, 12:55pm UTC](https://forum.heroiclabs.com/t/unity-sendmatchstateasync-authoritative-presences-on-server-side/825 "2025-06-22T12:55:37Z")
Hey, I’m developping something with go server authoritative + Unity, I have an issue with ISocket.SendMatchStateAsync. I pass as parameters recipients some users but on go side I receive in the Match.MatchLoop a runtime… --- ## [IAP with TS and unity](https://forum.heroiclabs.com/t/iap-with-ts-and-unity/6230)
**Author:** [@developerdinno](https://forum.heroiclabs.com/u/developerdinno)\ **Replies:** 4\ **Last updated:** [June 4, 2025, 7:15am UTC](https://forum.heroiclabs.com/t/iap-with-ts-and-unity/6230 "2025-06-04T07:15:01Z")
Hello, Im trying to implement google IAP here. i did client\_email: "\" private\_key: "\" package\_name: "\" refund\_check\_period\_min: 15 a… --- ## [Error : "Context canceled" and "Context deadline exceed"](https://forum.heroiclabs.com/t/error-context-canceled-and-context-deadline-exceed/122)
**Author:** [@mohsenyz](https://forum.heroiclabs.com/u/mohsenyz)\ **Replies:** 11\ **Last updated:** [May 19, 2025, 6:21pm UTC](https://forum.heroiclabs.com/t/error-context-canceled-and-context-deadline-exceed/122 "2025-05-19T18:21:00Z")
Hello everybody, I’ve many errors about “Context canceled” and “Context deadline exceed” in important parts of RPC codes, Like executing SQL, updating wallets and … Which causes scripts to be run incompletely, and making… --- ## [Connect to Nakama with https instead of http](https://forum.heroiclabs.com/t/connect-to-nakama-with-https-instead-of-http/1328)
**Author:** [@RandomDuck](https://forum.heroiclabs.com/u/RandomDuck)\ **Replies:** 6\ **Last updated:** [May 7, 2025, 7:34am UTC](https://forum.heroiclabs.com/t/connect-to-nakama-with-https-instead-of-http/1328 "2025-05-07T07:34:00Z")
Hello, I was wondering if anyone here know how to connect to the Nakama server with https. When I tried changing http to https in Godot it’s says “HTTPRequest failed!”, and I can’t find anything in the Nakama documentat… --- ## [Unreal 5 Self hosted server](https://forum.heroiclabs.com/t/unreal-5-self-hosted-server/6185)
**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")
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… --- ## [Game crash in web](https://forum.heroiclabs.com/t/game-crash-in-web/6136)
**Author:** [@Zerof99](https://forum.heroiclabs.com/u/Zerof99)\ **Replies:** 0\ **Last updated:** [April 4, 2025, 1:43pm UTC](https://forum.heroiclabs.com/t/game-crash-in-web/6136 "2025-04-04T13:43:27Z")
Game crash when i test it in local server . I think the reason is client.AuthenticateDeviceAsync( In this code : if (session == null) { ScreenLog($“Authenticating with Device ID: {\_deviceId}”, true); try { sessio… --- ## [403 or 500 Error when loading metadata from docker](https://forum.heroiclabs.com/t/403-or-500-error-when-loading-metadata-from-docker/6119)
**Author:** [@ryanprice](https://forum.heroiclabs.com/u/ryanprice)\ **Replies:** 1\ **Last updated:** [March 25, 2025, 4:30pm UTC](https://forum.heroiclabs.com/t/403-or-500-error-when-loading-metadata-from-docker/6119 "2025-03-25T16:30:05Z")
Is anyone else getting this error this morning? I am doing the usual docker compose up --build and getting this error. docker compose up --build \[+\] Running 0/1 \[+\] Running 0/1ma Building … [Next page](https://forum.heroiclabs.com/c/help/10.md?page=1)