How to Create a Starbound Server Guide: Difference between revisions
[wiki:ss-claude-11372] Cut filler: notes about the page itself, repeated lines, empty phrases and decorative pictures (Ryan 2026-10-15) |
[wiki:wiki-operator] Reworded to the house writing rules; facts that were wrong today corrected (approved by Ryan, Nov 17) |
||
| Line 1: | Line 1: | ||
{{#seo:|title=Starbound Dedicated Server Hosting: Rent or Host Your Own|description=How to set up a Starbound dedicated server: rent one with Workshop mods installed for you, or run the free server tool on your own PC with SteamCMD.}} | {{#seo:|title=Starbound Dedicated Server Hosting: Rent or Host Your Own|description=How to set up a Starbound dedicated server: rent one with Workshop mods installed for you, or run the free server tool on your own PC with SteamCMD.}} | ||
Starbound | Starbound has an official dedicated server, so you can run a universe that stays online for your friends to join any time. | ||
== Before you start == | == Before you start == | ||
The dedicated server is a separate free download on Steam (app <code>533830</code>), but it | The dedicated server is a separate free download on Steam (app <code>533830</code>), but it '''can't''' be installed anonymously. Its licence comes with the base game, so the PC has to sign in to SteamCMD with an account that owns Starbound. The Windows server files take about 320 MB, plus room for your universe, and the server needs one port. | ||
'''Note:''' | '''Note:''' Plenty of guides say the server tool installs anonymously. It doesn't. Anonymous SteamCMD returns <code>No subscription</code> for app 533830. | ||
== Installing the server == | == Installing the server == | ||
| Line 13: | Line 13: | ||
# Install the server signed in as an account that owns Starbound: <code>steamcmd +login yourname +app_update 533830 validate +quit</code> | # Install the server signed in as an account that owns Starbound: <code>steamcmd +login yourname +app_update 533830 validate +quit</code> | ||
# Start it from '''inside''' its <code>win64</code> or <code>linux</code> folder: <code>win64\starbound_server.exe</code> on Windows, <code>linux/run-server.sh</code> on Linux. | # Start it from '''inside''' its <code>win64</code> or <code>linux</code> folder: <code>win64\starbound_server.exe</code> on Windows, <code>linux/run-server.sh</code> on Linux. | ||
# Forward TCP port <code>21025</code> on your router and allow it through the firewall. Forward the same number on UDP as well, and set <code>runQueryServer</code> to <code>true</code>, if you want the server to | # Forward TCP port <code>21025</code> on your router and allow it through the firewall. Forward the same number on UDP as well, and set <code>runQueryServer</code> to <code>true</code>, if you want the server to show up in server lists. | ||
'''Note:''' | '''Note:''' The folder you start it from matters. The <code>sbinit.config</code> file next to the server program points at <code>..\assets\</code>, <code>..\mods\</code> and <code>..\storage\</code> with relative paths. Start the server from anywhere else and it loads a different set of assets and saves, with no warning. | ||
== Configuration == | == Configuration == | ||
Settings | Settings are in <code>storage/starbound_server.config</code>, a JSON file the server writes on its first start. Two things to know before you edit it: | ||
* If the file | * If the file has an error, the server renames it to <code>starbound_server.config.old</code> and starts with the default settings. The only sign is a warning in <code>storage/starbound_server.log</code>. A single stray comma undoes all your settings. | ||
* Edit it '''while the server is stopped'''. Starbound rewrites the file on a clean shutdown, so changes made while it | * Edit it '''while the server is stopped'''. Starbound rewrites the file on a clean shutdown, so changes made while it's running are lost. | ||
Settings most people change: <code>serverName</code>, <code>maxPlayers</code> (default 8), <code>gameServerPort</code>, <code>serverFidelity</code>, <code>allowAssetsMismatch</code> and the scripting limits that large modpacks need. | |||
== Access and admin == | == Access and admin == | ||
| Line 38: | Line 38: | ||
== Mods == | == Mods == | ||
Mods are <code>.pak</code> files in the <code>mods</code> folder. There | Mods are <code>.pak</code> files in the <code>mods</code> folder. There's one trap that catches nearly everybody: | ||
'''Note:''' | '''Note:''' Every Steam Workshop item uses the same file name, <code>contents.pak</code>. Copy several into <code>mods</code> without renaming them and they overwrite each other, leaving only one mod installed. Give each one a unique name first. | ||
That | That's why people report that large modpacks such as Frackin' Universe "don't work" on a dedicated server. Mods overwrite each other, and a plain dedicated server has no Steam subscription to download them from. | ||
== The instant alternative == | == The instant alternative == | ||
To skip the Steam sign-in, the port forwarding and the mod renaming, [https://www.survivalservers.com/services/game_servers/starbound/ rent a Starbound server] from Survival Servers. Workshop mods install from a browser in the Command Center. The settings file is rebuilt from your settings on every start, so a typo can't break it. Backups and full FTP access are there from day one. | |||
Latest revision as of 08:49, 17 November 2026
Starbound has an official dedicated server, so you can run a universe that stays online for your friends to join any time.
Before you start
The dedicated server is a separate free download on Steam (app 533830), but it can't be installed anonymously. Its licence comes with the base game, so the PC has to sign in to SteamCMD with an account that owns Starbound. The Windows server files take about 320 MB, plus room for your universe, and the server needs one port.
Note: Plenty of guides say the server tool installs anonymously. It doesn't. Anonymous SteamCMD returns No subscription for app 533830.
Installing the server
- Install SteamCMD.
- Install the server signed in as an account that owns Starbound:
steamcmd +login yourname +app_update 533830 validate +quit - Start it from inside its
win64orlinuxfolder:win64\starbound_server.exeon Windows,linux/run-server.shon Linux. - Forward TCP port
21025on your router and allow it through the firewall. Forward the same number on UDP as well, and setrunQueryServertotrue, if you want the server to show up in server lists.
Note: The folder you start it from matters. The sbinit.config file next to the server program points at ..\assets\, ..\mods\ and ..\storage\ with relative paths. Start the server from anywhere else and it loads a different set of assets and saves, with no warning.
Configuration
Settings are in storage/starbound_server.config, a JSON file the server writes on its first start. Two things to know before you edit it:
- If the file has an error, the server renames it to
starbound_server.config.oldand starts with the default settings. The only sign is a warning instorage/starbound_server.log. A single stray comma undoes all your settings. - Edit it while the server is stopped. Starbound rewrites the file on a clean shutdown, so changes made while it's running are lost.
Settings most people change: serverName, maxPlayers (default 8), gameServerPort, serverFidelity, allowAssetsMismatch and the scripting limits that large modpacks need.
Access and admin
Starbound has no plain server password. Access is accounts:
serverUsersmaps an account name to a password and an admin flag, for example"fred" : { "admin" : true, "password" : "hunter2" }.allowAnonymousConnectionsdecides whether anyone without an account may join at all. Set it tofalseand only your listed accounts get in.- To become admin, give your own account
"admin" : true, log in with it, then type/adminin chat.
Source RCON is available but off by default. Set runRconServer to true, give rconServerPassword a value and forward rconServerPort (21026 by default) if you want a remote console.
Mods
Mods are .pak files in the mods folder. There's one trap that catches nearly everybody:
Note: Every Steam Workshop item uses the same file name, contents.pak. Copy several into mods without renaming them and they overwrite each other, leaving only one mod installed. Give each one a unique name first.
That's why people report that large modpacks such as Frackin' Universe "don't work" on a dedicated server. Mods overwrite each other, and a plain dedicated server has no Steam subscription to download them from.
The instant alternative
To skip the Steam sign-in, the port forwarding and the mod renaming, rent a Starbound server from Survival Servers. Workshop mods install from a browser in the Command Center. The settings file is rebuilt from your settings on every start, so a typo can't break it. Backups and full FTP access are there from day one.