Skip to main content
Version: bleeding-edge 🩸

Server Installation

Creating servers in nanos world is very simple and straightforward, just a few steps and you have your server up and ready!

System Requirements​

  • OS: Windows or Linux
  • Processor: 1.0 GHz (Faster core is better than multiple cores)
  • Memory: 50 MB (grows if having too many Players or spawned Entities)
  • Storage: 10 MB (+ Assets & Packages size)
  • Network: Recommended at least 1 MB/s (grows if having too many Players or spawned Entities)
  • Network Forwarded Ports: 7777 TCP/UDP and 7778 UDP (you can change that in the Config)

The default installation of nanos world already contains the server executable, you can find it at nanos-world/Server/NanosWorldServer.exe. You can use this one to create your custom Packages as it seamlessly integrates with New Game menu screen!

Installing (Linux and Windows)​

nanos world servers are downloaded through SteamCMD, a command line version of Steam. Please download it before proceeding.


If you are on Linux Ubuntu/Debian machine, you can easily install it like that:

sudo add-apt-repository multiverse
sudo dpkg --add-architecture i386
sudo apt update
sudo apt install lib32gcc1 steamcmd

1. Run SteamCMD​

After downloaded, run steamcmd executable, it will update and you will enter it's console:


2. Specify an installation directory​

You can optionally define an installation folder to install nanos world server:

Steam> force_install_dir c:\nanos-world-server\

3. Login​

The next step is to login on SteamCMD, you can login anonymously with:

Steam> login anonymous

4. Download nanos world Server​

You can then install nanos world server using it's app id: 1936830:

Steam> app_update 1936830

You can run app_update 1936830 to update your nanos world server to the latest version as well!

And you are done! You can quit the console:

Steam> quit

Running on Linux​

On Linux, you must start the server using the Shell Script ./, which will configure proper paths and needed dynamic libraries which need to be loaded!

Automated Installation​

You can optionally use a one-liner command to install/update nanos world server:

steamcmd.exe +login anonymous +app_update 1936830 validate +quit

Finished!, you can now proceed to the next steps to configure your nanos world server.

Installing bleeding-edge version​

To install the bleeding-edge version of the server, you will need to specify it's branch when installing:

Steam> app_update 1936830 -beta bleeding-edge


steamcmd.exe +login anonymous +app_update "1936830 -beta bleeding-edge" validate +quit

Linux Debian 10 Installation​


Follow this part if you have this kind of problem : version GLIBCXX 3.4.26 not found

For this distribution, some extra steps are required. Since nanos world use gcc 9, we will need to upgrade one of our package to the testing repository.

First, update your sources.list file (located in: /etc/apt/sources.list), you will need to add the testing repo source, you can add theses lines below to your sources:

deb testing main contrib non-free
deb-src testing main contrib non-free

After that, we will need to create a preferences file that will tell our system to not prefer installing testing package over stable unless specified. In /etc/apt/preferences (create if it doesn’t exists), add theses lines:

Package: *
Pin: release a=stable
Pin-Priority: 700

Package: *
Pin: release a=testing
Pin-Priority: 650

Now, update your server to make sure that your system can find testing repositories with this command:

sudo apt update

We will install libstdc++6 testing package to the server, it will allow the server to start correctly. You can type the command below to install it:

sudo apt-get --target-release testing install libstdc++6

Finished!, you can now proceed to the next steps to configure your nanos world server.

Linux ARM (raspberry & more)​


EXPERIMENTAL : Use at your own risk!, unstable

Nanos world server is not officially supported on Arm, but if you really really really want your server to be running on arm platform such as a raspberry, rockpro64, ... then you can !

We will need 2 emulators :

You must build & install these emulators on your board. box86 is optional if you don't want to use steamcmd to download & update the server

Follow CAREFULLY the instructions on the emulators repository, commands are different in function of the board.

Example :

  • RK3399 is for Pine64, RockPro64, Orange Pi, ...

These steps have been tested on Armbian Bullseye 64bits (aarch64) on a rockpro64. Some extra steps might be required for other boards & distros


To install it, simply follow the instructions here:

If for some reason, your system cannot find Box86 and you are on a 64bits os, run theses commands:

sudo dpkg --add-architecture armhf
sudo apt update
sudo apt install libc6:armhf libncurses5:armhf libstdc++6:armhf


Clone the repository, then we will need to replace the file inside the folder x64lib. You will need a newer version of this file with at least GLIBCXX v3.4.26. You can grab it inside an updated Linux distro such as Ubuntu 20.04, Debian 11. To check if the file has at least GLIBCXX v3.4.26, use this command :

strings | grep LIBCXX

If it shows GLIBCXX v3.4.26, you can put this file inside x64lib folder.

You can now follow the rest of the instructions here (starting from mkdir steps since you already cloned the repo):

Steam & Server​

You have now installed the emulators, they should be able to auto-detect if a program needs a x86_64/x86 emulation or not.

Get steamcmd manually on a folder with this command :

curl -sqL "" | tar zxvf -

You can now follow the basic instructions of nanos world Linux installation starting from steamcmd (run steamcmd with this command: ./


Finished!, you can now proceed to the next steps to configure your nanos world server.