Hardware FixRecommendedDevice not working? Your driver may be the problemCheck updates for common hardware issues.Fix DriversOctober DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsPC HealthRecommendedCrashes, freezes, slowdowns? Check your PC nowSpot repairable issues before they interrupt work.Check PC×
Skip to content
World desk9 min

How to Run a Starbound Server in Docker

Run Starbound in Docker with a persistent data mount, the required TCP port mapping, and an image-specific Steam installation or update workflow.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Run Starbound in a Linux Docker container by using a community image with a documented startup process, publishing TCP port 21025, and keeping the server’s data directory on persistent storage. The steps below use the Didstopia image; other community images differ in how they handle Steam credentials, updates, and file ownership.

What you need before starting

You need Docker on a Linux host or another Docker-capable system, a community Starbound server image, and a Steam account that owns Starbound. The image uses Steam credentials when installing or updating the game. If the account has Steam Guard enabled, be prepared to enter a verification code in an interactive terminal.

As an Amazon Associate I earn from qualifying purchases.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

You also need a place on the host to keep the server’s files. The example uses /srv/starbound; choose a directory that exists or that you can create and manage. Keeping the game data outside the container means it can persist when the container is stopped, removed, or replaced.

No authoritative hardware minimums or player-capacity figures are established for these images. Start with the resources available on your host, then monitor actual CPU, memory, disk, and network use under your expected workload rather than relying on an invented universal minimum.

#1 Best Overall
Sale
TOZO A1 Wireless Earbuds Bluetooth 5.3 Light Weight in Ear Headphones | IPX5 Waterproof,2 Mics for AI Calls,Immersive Premium Sound Bass Headset with Charging Case,32 EQ via App Black
  • [Ultra-Lightweight Ear Buds Designed for Small Ears] Each earbud weighs only 3.7g and features a compact, ergonomic in-ear design made especially for small ears. Secure, low-profile, and comfortable for workouts, all-day wear or overnight sleeping.The ultra-slim profile sits flush in your ear with no hard edges poking or rubbing, so you can even sleep on your side without discomfort.
  • [Immersive Stereo Sound with TOZO OrigX Technology] TOZO OrigX tuning delivers clear vocals, balanced mids, and natural stereo sound for music, podcasts, and videos.
  • [Long Battery Life for Daily Use] Get up to 7 hours of playtime on a single charge, with up to 32 hours total using the charging case—ideal for workdays, commuting, and extended listening sessions.
  • [Bluetooth 5.3 & Stable Connection] Bluetooth 5.3 provides fast pairing, stable wireless performance, and reduced dropouts as you move around home or office.
  • [Deep Bass with Clear Vocals] High-performance drivers produce punchy bass while keeping vocals clean and detailed for everyday listening.

Start a Didstopia Starbound container

The Didstopia project describes its image as a dedicated Linux server for Starbound running inside a Docker container. Its documented data tree is rooted at /steamcmd/starbound. The following detached command publishes the game port and maps that tree to persistent host storage:

docker run -d 
  --name starbound 
  --restart unless-stopped 
  -p 21025:21025/tcp 
  -v /srv/starbound:/steamcmd/starbound 
  -e STEAM_USERNAME='your-steam-name' 
  -e STEAM_PASSWORD='your-steam-password' 
  didstopia/starbound-server
  1. Prepare the host directory. Create /srv/starbound if it does not exist, and ensure the Docker process can write to it. This is the host side of the bind mount; the image reads and writes its Starbound files at /steamcmd/starbound.
  2. Substitute your Steam account details. Replace the example username and password with credentials for an account that owns Starbound. Do not copy the example values literally.
  3. Run the command. Docker creates a container named starbound, maps host TCP port 21025 to the container’s TCP port 21025, and restarts the container unless it is explicitly stopped.
  4. Check the container’s startup output. The image handles installation or updating at startup when Steam credentials are present. If it pauses for a Steam Guard code, use the interactive procedure below rather than assuming startup has completed.

The example puts credentials directly in a shell command. That can expose them through shell history, process or administration records, or a copied command. Treat the example as a demonstration of the image’s environment-variable contract, not as a safe way to publish secrets. Never commit credentials in a Compose file or source repository, and do not include them in public issue reports. Use a secret-handling method appropriate to your host and deployment, and restrict access to any file or mechanism that stores them.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Handle Steam Guard with an interactive terminal

A detached container launched with -d does not provide the attached terminal needed to answer an interactive Steam Guard prompt. When the image asks for a verification code, start it with standard input and a TTY attached by using Docker’s -it options. For the initial run, use the same name, port mapping, mount, and credentials as in the previous command, but omit -d and add -it:

Rank #2
Sale
Smart Watch for Men Women Compatible with iPhone Samsung Android Phone 1.69 inch Full Touch Screen IP68 Waterproof Bluetooh Fitness Tracker Heart Rate/Sleep Monitor (Black)
  • 【IP68 Waterproof Multifunctinal Smart Watch】Torjalph fitness activity tracker smart watch is IP68 waterproof technology ,you can wear it when swimming,handwashing,it's rain-proof which means that you perform multiple exercise modes outside without worrying about sweat or rain corroding your fitness smart watch,and this watch equipped with a 230 mAh large capacity battery magnetic charging ,and this sports activity tracker watch can be used 5-7 days If fully charged.
  • 【Larger 1.83'' Full Screen Watch & Multi-dial Selection】1.83 inch full HD color touch screen smart watch for men / women provides excellent 240*284 resolution image quality ,This Bluetooth smart watch offers a better touch experience and remarkable immersion and ,more than 200 watch faces for you to choose from App"Da Fit ", you can change the dial style according to your mood to wear keeping the world on your wrist
  • 【Accurate Activity Tracker Smart Watch 】sports watch activity tracker uses sweat and dust resistant breathable silicone strap, our Fitness Tracker Smart Watch for Android iOS Phones supports 12 sports modes,walking,running,bicycle,swimming,badminton,basketball,football,rope skipping. This bluetooth calls smart watch for men women is lightweight and stylish, bringing more convenient and relaxing sports experience while also providing more protection.
  • 【Your 24 Hour Personal Daily Health Monitor】Fitness watch for women men full touch screen IP67 waterproof bluetooth smartwatch for Android iOS Phones with heart rate blood pressure monitor multifunction Andriod smart watch with steps counter sleep monitor sports fitness watch, monitoring blood oxygen saturation allows you to understand your physical condition in real time to track fitness progress ,to know your health status in time.
  • 【More Functions Bluetooth Call Smart Watch】This fitness activity smart watch full screen for iPhone and Android phones includes a bunch of new features including:The bluetooth smart watch can hang up the phone, receive and display WhatsAPP /Text /Facebook /Twitter /Messenger reminder.Support sedentary reminder, alarm clock, stopwatch, timer,weather information,music control, remote camera control compatible with Android 5.0 and above or iOS 9.0 and above smartphones.
docker run -it 
  --name starbound 
  --restart unless-stopped 
  -p 21025:21025/tcp 
  -v /srv/starbound:/steamcmd/starbound 
  -e STEAM_USERNAME='your-steam-name' 
  -e STEAM_PASSWORD='your-steam-password' 
  didstopia/starbound-server

Enter the Steam Guard code only when the image prompts for it. This interactive command runs in the foreground, so keep the terminal available while the prompt is active. Do not launch a second container with the same name while the first one still exists; if you already created a detached container, resolve that container first rather than layering a duplicate over it. Once authentication and the image’s installation or update work have completed, follow the image’s documented process for operating the resulting container. The exact post-authentication workflow is image-specific.

Make the server reachable on TCP 21025

The image documents TCP port 21025 for Starbound. The -p 21025:21025/tcp option publishes that container port on the Docker host. Docker’s port-publishing documentation explains that a container port is not reachable from outside the host unless it is published with -p or --publish.

Publishing the port is only one part of network access. Check the path the connection must take:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #3
New Bee Guitar Cable 10ft Electric Instrument Bass AMP Cord
  • [Low Noise High Fidelity] New bee guitar cord with 22AWG oxygen-free-copper center conductors provides enhanced signal transfer, the PVC insulation material and the high-density stranded copper double shield provide noise rejection for quiet operation
  • [Ideal for Choice] New bee 1/4 straight and right angle metal connectors, ensures a secure connection in any instrument, pedal, or amp jack. L shape great fro on stage guitar stands
  • [Wide Compatible] Suitable for mixer, power amplifier, microphone, effector, decoder, equalizer, electoronic organ, electric guitar, electric bass and other electronic equipments. Widely used in the installation of smart home, karaoke speaker, professional stage audio, etc
  • [Easy Disassemble] Making incidental repairs quick and easy! Very nice, flexible cable
  • [Dont Hesite to Order] 24 hours customer services and professional technology team are standing by
  • Docker host: Keep the port mapping in the container’s run configuration. If you change or recreate the container, make sure the mapping remains present.
  • Host firewall: Allow inbound TCP traffic on port 21025 to the Docker host. A Docker port mapping does not by itself guarantee that the host firewall permits outside connections.
  • Router, for Internet play: Forward TCP port 21025 from the router to the Docker host’s network address. This step is not needed for players connecting only within a network where the host is already reachable.

Use the correct reachable address for the network you are connecting from. A mapping can be correct while an upstream firewall or router still blocks traffic. The documented image port is TCP; do not assume a UDP mapping is required by this setup.

Keep worlds, configuration, and mods persistent

The bind mount in the run command maps the host directory /srv/starbound to /steamcmd/starbound inside the container. This is the critical boundary between replaceable container state and files you need to keep. The Didstopia layout places the key files and directories here:

Purpose Path inside the container What to do
Server configuration /steamcmd/starbound/storage/starbound_server.config Edit this file to change server configuration; the corresponding host path is /srv/starbound/storage/starbound_server.config.
World and save data /steamcmd/starbound/storage/universe Keep this directory on the mounted persistent storage. Its host path in the example is /srv/starbound/storage/universe.
Mods /steamcmd/starbound/mods Put and maintain the server’s mod files under the mounted tree, at host path /srv/starbound/mods in this example.

The image documentation identifies /steamcmd/starbound/storage/universe for save files and /steamcmd/starbound/mods for mods. The mount makes those paths available under the host directory, so back up the host-side data rather than relying on the container’s writable layer. Keep the configuration, saves, and mods together with the mounted tree when moving or rebuilding the server.

Rank #4
BSIMB 15.6" Digital Family Calendar & Chore Chart, No Subscription Fees
  • Digital Family Calendar: BSIMB digital calendar wall touch screen puts an end to your chaotic life. Designed for busy families, the digital calendar keeps you organised and in step with your family. Assign different colours and tasks to each family member to make family scheduling easier and more intuitive.
  • Easy Setup and Auto-Sync: Plug in, connect to WLAN and auto-syn your electric calendar in minutes. Digital wall calendar compatible with Google calendar, iCloud calendar, Outlook calendar, Cozi calendar and Yahoo calendar. Add events directly on the device or through the ecalendar app. Electronic calendar stays current whether you're at work or traveling—no manual updates needed.
  • All-In-One Home Assistant: Smart calendar builds habits and encourage independence with personalised chores. Display daily meal plan to reduce the daily ‘What's for dinner?’ stress. To-do lists keep track of everything you want. Turning chores into valuable achievements with stars and rewards, making life easier and more enjoyable.
  • Manage Anytime Anywhere: BSIMB electronic calendar for family stay connected with the powerful ecalendar app. Access and manage your digital wall calendar anytime, anywhere with free features like stars & rewards, photo screensaver, chore charts, meals plans, to-do lists etc. Electronic planner paid features like Magic Import tailor advanced tools for users with special needs.
  • Stay in Touch with Loved Ones: Share photos or videos from your phone to electronic wall calendar with app, instantly update your life moment, and keep in touch with your family, especially those who are far away; you can also surprise your smart calendar digital wall by sending him a wish card; it's also great for keeping tech-illiterate elders in touch with the youngsters.

Before deleting or recreating a container, confirm that the data is actually present under the host directory or named volume you intend to retain. If you omit the mount or point it at a different host directory during recreation, the new container may start with a different data tree and appear to have lost its prior configuration or world. Preserve a backup before making substantial configuration or mod changes.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Choose an image based on its update and storage workflow

Community images are not interchangeable. The documented workflows differ, and the available information does not establish a single best image for every deployment. Compare the behavior that affects your operation before selecting one, then read the image’s current README and pin a reviewed image tag where one is available.

Image Update and credential workflow Data path or persistence Other documented details
Didstopia Uses Steam credentials for installation or updates on startup. Steam Guard may require an interactive terminal and TTY. Mount /steamcmd/starbound; documented config, universe, and mods paths are inside that tree. Documents TCP port 21025. The specific Compose, UID/GID, mod-ID, image-freshness, and pinned-tag details are not stated here.
morgyn Documents an interactive update.sh workflow rather than the Didstopia startup update process. Not stated in the documented comparison. Compose support, UID/GID behavior, mod support, image freshness, and pinned-tag availability are not stated here.
hetsh Uses a fixed game version in each image build. Documents a bind mount at /starbound. Compose support, UID/GID behavior, mod support, image freshness, and pinned-tag availability are not stated here.
azureowl Credential and update behavior is not stated in the documented comparison. Documents a host-volume pattern. Documents a Compose pattern, UID/GID ownership, optional mod IDs, and TCP port 21025. Image freshness and pinned-tag availability are not stated here.

“Not stated” means the documented comparison does not establish that behavior; it is not proof that an image cannot support it. For production use, check the current README for the exact image and tag you plan to run, including how it handles updates, data paths, ownership, Steam authentication, and mods. A fixed game version per build and an update-on-startup workflow have different operational consequences: one makes the version part of the selected image build, while the other can change installed game files when the container starts.

Update and maintain the deployment carefully

Do not assume an image’s update behavior from another image’s instructions. With Didstopia, the documented behavior is installation or updating on startup when Steam credentials are present. The morgyn image documents running update.sh interactively, while hetsh documents a fixed game version in each image build. azureowl’s documented Compose pattern includes optional mod IDs and ownership settings, but the available description does not establish its credential or update workflow.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Before changing image tags or update methods, protect the mounted data tree and note the current configuration and mods. A reviewed, pinned image tag can make the selected image version explicit; check the image’s current documentation for the tag syntax and availability rather than assuming that a particular tag exists. Do not rely on an image as a permanent dependency without periodically verifying that its instructions and maintenance status still fit your needs.

Troubleshoot common connection and startup problems

Players cannot connect from outside the host

  • Confirm the container was started with -p 21025:21025/tcp.
  • Check that the host firewall permits inbound TCP port 21025.
  • For Internet connections, verify that the router forwards TCP port 21025 to the Docker host, not to a different machine.
  • Check that players are using an address reachable from their location. A port published on the host does not eliminate router or firewall restrictions.

The container stops or waits during setup

  • Inspect the startup output to determine whether the image is installing or updating, or waiting for Steam authentication.
  • If Steam Guard is prompted, run the container with an attached TTY and standard input using -it; detached mode cannot receive an interactive code in the terminal.
  • Confirm the Steam account owns Starbound and that the credentials are valid. Do not post the password or verification code in a support request.
  • Check the selected image’s README for its current startup and update contract. A different community image may require a different procedure.

The server appears to have lost its world or configuration

  • Check that the container still maps the intended host directory to the image’s documented data path.
  • For Didstopia, verify the host-side paths corresponding to storage/universe, storage/starbound_server.config, and mods beneath the bind-mounted directory.
  • Check whether the container was recreated with a different mount source or without a mount. Avoid deleting the old container or data directory until you have verified where the previous files are stored.

The container cannot write to the mounted directory

Check host-directory ownership and permissions. Image behavior around non-root execution and UID/GID is not uniform: azureowl documents a Compose pattern with UID/GID ownership, but that should not be assumed for the other images. Use the ownership instructions for the specific image you selected rather than applying an arbitrary user ID.

Plan capacity from actual use

The available image documentation does not publish authoritative CPU, RAM, bandwidth, disk, or player-capacity requirements. Server demand can vary with the world and workload, so no single minimum figure is justified here. Monitor resource use on the host while people play, leave operational headroom for other services, and expand storage as the persistent universe and other files grow. If you do not want to manage a Docker host, a VPS or managed game-server host is an alternative only if it supports Docker, persistent storage, and the port and firewall controls this setup needs.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Leave a Reply

Your email address will not be published. Required fields are marked *

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
Crashes, No Sound, or Screen Glitches?Free driver scan
PC Slower Than It Used to Be?Free scan - under a minute

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.