Skip to main content
Version: latest - a1.104.x ⚖️

Server Installation

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

Minimum System Requirements​

  • OS: Windows or Linux*
  • Processor: 2x 1.0 GHz (faster cores is better than many cores)
  • Memory: 50 MB (grows if having too many Players or spawned Entities)
  • Storage: 30 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)

Windows​

Requirements

The Windows server needs the latest Microsoft Visual C++ Redistributable to work.

On Windows, you have four options for downloading nanos world server:

  1. Use the executable (.exe) already located at the game's folder nanos-world/Server/NanosWorldServer.exe (recommended).
  2. Download nanos world™ Dedicated Server tool from Steam Client.
  3. Download through SteamCMD.
  4. Using Docker (maintained by the community).

Linux​

Recommended and Tested Distros

Our Linux servers are currently compiled in a Ubuntu 22.04 machine (with glibc version 2.35).

The following Distros are granted to be supported out of the box:

  • Ubuntu 24.04 (recommended)
  • Ubuntu 22.04
  • Debian 12

You can see a community created page with instructions on how to install the server on other distros and versions here. Alternatively, for other distributions or an easier setup, consider using the community maintained Docker, which handles all dependencies automatically.

On Linux, you have two options for downloading nanos world server:

  1. Download through SteamCMD (officially supported).
  2. Using Docker (maintained by the community).

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

Installing SteamCMD on Linux​

If you are on Ubuntu/Debian, you can easily install SteamCMD like that:

To install SteamCMD on Ubuntu, the multiverse repository and x86 packages must be enabled:

sudo add-apt-repository multiverse; sudo dpkg --add-architecture i386; sudo apt update

Then you can install SteamCMD using the following command:

sudo apt install steamcmd
tip

See the SteamCMD official installation instructions for more details.

Downloading with SteamCMD​

To download the server through SteamCMD (a command line version of Steam) please download it from the Steam official website before proceeding.

Manual Installation​

1. After downloaded run steamcmd executable, to enter into it's console:​

 

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

force_install_dir C:/nanos-world-server/

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

login anonymous

4. You can then install or update nanos world server using it's app id: 1936830:​

app_update 1936830 validate

Or to install the bleeding-edge version, specify it's branch:

app_update 1936830 -beta bleeding-edge validate

And you are done! You can quit the console:​

quit
info

To revert to default branch, install it forcing the public branch: app_update 1936830 -beta public.

One-liner Installation​

An easier way to install or update nanos world server is using an one-liner command to run SteamCMD:

steamcmd.exe +force_install_dir C:/nanos-world-server +login anonymous "+app_update 1936830 -beta public" validate +quit

or on bleeding-edge:

steamcmd.exe +force_install_dir C:/nanos-world-server +login anonymous "+app_update 1936830 -beta bleeding-edge" validate +quit
tip

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