DriversRecommendedOutdated drivers can make a good PC feel brokenScan driver issues before chasing fixes manually.Scan NowOctober DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsWindows FixRecommendedWindows errors stealing your time? Find the fix fastScan stability, cleanup and performance issues.Fix Now×
Skip to content
World desk10 min

How to Upload an Existing World to a Don’t Starve Together Dedicated Server

A precise, backup-first guide to moving complete and client-hosted Don’t Starve Together worlds to a dedicated server, including cluster paths, shard commands, saveindex conversion, and Day 1 troubleshooting.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

To move an existing Don’t Starve Together world, stop the destination server, copy the source cluster’s cluster.ini plus its complete Master and Caves shard folders into the cluster directory the server actually launches, add server_token.txt, and start every shard with matching -cluster and -shard values. A Day 1 world almost always means the server loaded a different path, cluster name, shard name, or session; stop it and restore your backup before changing anything else.

What the server must find

A DST dedicated server does not search your computer for the newest save. It loads one named cluster from the persistent-storage path selected at launch. The cluster root must contain cluster.ini; the world data sits in shard directories below it. Klei’s documented layout uses a Master folder for the surface (Forest) shard and a Caves folder for the caves shard.

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.

The documented default persistent-storage roots are DocumentsKlei on Windows and ~/.klei on Linux. The default configuration directory is DoNotStarveTogether. A launch option can change either location: -persistent_storage_root changes the root, while -conf_dir changes the configuration directory. The server expects the cluster file at:

<persistent_storage_root>/<conf_dir>/<cluster>/cluster.ini

If you copy a world into a folder that is not selected by -cluster, the server will ignore it and create or open another world. Folder names and command-line values are therefore part of the save, not cosmetic labels.

#1 Best Overall
Elebase USB to USB C Adapter for iPhone 18 Pro Max,USBC Car Charger Adapter | 4Pack Type C Female to A Male Cable Converter for Apple Duo 17 16 15 14 Plus,iWatch Watch 12 11 10,iPad 9 8 Air,Airpods 5 4
  • Read Before You Buy — No Video Output: These adapters support charging and USB 2.0 data transfer, but cannot transmit video signals. Except for standard USB webcams (which use USB data only), they are not compatible with HDMI/DisplayPort cables, video-capable USB-C hubs, or docking stations with video output.
  • Convert USB-A Ports to USB-C: Designed to connect USB-C earphones, cables, flash drives, card readers, and other USB-C accessories to standard USB-A ports. Plug-and-play with no drivers or software required.
  • Aluminum Alloy Housing: Built with a sturdy aluminum alloy shell that aids in heat dissipation and protects against daily wear and scratches. Designed to maintain a stable and secure connection.
  • Compact & Travel-Friendly: The ultra-compact design allows the adapter to stay plugged into your device without blocking adjacent ports or adding bulk, reducing wear and tear on your original USB ports.
  • 12-Month Warranty: Backed by a 12-month manufacturer warranty for peace of mind. Designed to meet strict quality control standards for reliable everyday performance.

Before copying anything

Stop both destination processes

Shut down the destination server completely, including both the surface and caves processes if you run separate shard processes. Do not overwrite files while a shard is saving; an active process can rewrite the files you just copied.

Back up the destination cluster

Make a copy of the destination cluster directory before replacing it. Keep the source world untouched as well. Give the backup a clear name and store it outside the directory you plan to launch, so a failed start cannot overwrite your rollback copy.

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

Identify the launch configuration

Find the startup command, service definition, or control-panel fields used by the destination. Record the values for -persistent_storage_root, -conf_dir, -cluster, and -shard. If an option is absent, use the documented defaults above. You need this information before choosing a destination folder; otherwise it is easy to copy a valid save into an unused directory.

  • Windows default: DocumentsKleiDoNotStarveTogether.
  • Linux default: ~/.klei/DoNotStarveTogether.
  • Cluster root: the directory named by -cluster inside the selected configuration directory.
  • Required root file: cluster.ini.
  • Shard directories: normally Master and Caves, unless your launch commands use different configured names.

Choose the migration path

Source save Shard layout Recommended method Main risk
Complete cluster directory Surface only or surface plus caves Copy the cluster root and its shard folders, then launch the same cluster name Using a different path or shard name makes the server generate a new world
Client-hosted overworld-only save Surface data without a normal dedicated-server cluster Convert the save by moving saveindex and the matching session directory into the dedicated server’s generated structure Incorrect slot or session_id mapping can produce a fresh world or an unrecognized save
Any save with caves Master plus Caves Move both shard directories and start both processes with matching shard names Starting only the surface shard leaves caves unavailable or causes an inconsistent world

If you have a complete Cluster_X directory, use the direct-copy procedure. Reserve the manual conversion procedure for an overworld-only client save or a source whose files do not already form a usable cluster.

Directly upload a complete cluster save

1. Locate the source cluster

A complete source has a cluster-level cluster.ini and shard directories beneath it. Client-hosted saves are commonly under the Windows path DocumentsKleiDoNotStarveTogether; a cluster may appear as a directory such as Cluster_X. On Linux, inspect the corresponding configuration tree under ~/.klei or the alternate locations selected by your source launch settings.

Do not combine files from two worlds. The cluster configuration, shard data, world-generation overrides, mod settings, and session files must describe the same save.

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

2. Create the destination cluster directory

Under the destination’s selected persistent-storage and configuration roots, create or choose the directory named by your intended -cluster value. For example, if the command will use -cluster MyDediServer, the folder must be named MyDediServer. A differently named folder is not selected by that command.

Rank #2
Sale
Anker USB-C Hub, 5-in-1 USB Hub for Laptops, 4K HDMI Multiport Adapter
  • 5-in-1 USB-C Hub: Experience comprehensive connectivity featuring a Power Delivery input, two USB-A 2.0 ports, a USB-A 3.0 port, and an HDMI port. (Note: The USB-C power delivery input port is only for connecting an external wall charger to power your laptop and cannot power peripheral devices.)
  • 90W Pass-Through Charging: Achieve optimal charging with 90W pass-through power to your laptop, supported by a total input of 100W, with the hub reserving 10W for operational efficiency. (Note: Wall charger not included.)
  • Quick Data Transfers: Accelerate your productivity with rapid data transfers using a high-speed 5Gbps USB 3.0 port and two 480Mbps USB 2.0 ports.
  • 4K HDMI Display: Enhance your visual experience with a hub capable of delivering 4K resolution at 30Hz in both mirror and extend modes. Please note that this hub is compatible with MacBook (macOS 12 and newer), Windows 10 and 11, ChromeOS, and laptops equipped with DP Alt Mode and Power Delivery. Note: This device is not compatible with Linux.
  • What You Get: Anker USB-C Hub (5-in-1, 4K HDMI), welcome guide, 18-month warranty, and our friendly customer service.

3. Copy the cluster file and every shard folder

Copy the source cluster.ini into the destination cluster root. Then copy the complete Master directory and, when the world uses caves, the complete Caves directory. Preserve the names and contents; do not copy only individual files from inside a shard.

The resulting arrangement should conceptually look like this:

<persistent_storage_root>/
└── <conf_dir>/
    └── MyDediServer/
        ├── cluster.ini
        ├── server_token.txt
        ├── Master/
        └── Caves/

The exact additional files vary by world. Retain the source cluster’s server.ini, mod configuration, and world-generation override files when they are present and needed. A cluster root should not contain a mixture of settings from another save.

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

4. Add authentication and preserve configuration

Place server_token.txt in the cluster root. Keep the source cluster’s required configuration files alongside cluster.ini. If you intentionally change a setting, make that change after the first successful launch; changing several variables during migration makes a failure harder to diagnose.

5. Check ownership and access

The account running the dedicated server must be able to read the cluster root and write to both shard directories. If the server runs as a service or a separate Linux user, verify access for that account rather than only for your desktop login. Permission errors can look like a missing or newly generated save because the process cannot read the copied data.

Start the surface and caves shards

Klei’s documented command pattern for the surface process is:

dontstarve_dedicated_server_nullrenderer -console -cluster MyClusterName -shard Master

Start the caves process with the same cluster value and a caves shard value:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #3
Sale
Anker USB C Hub, 7in1 Multi-Port USB Adapter, 4K@60Hz USBC to HDMI Splitter | 85W Max PD, 2 USB 3.0 & 1 USBC Data Ports, SD/TF Card Reader, for Laptops/Mac and Other Type C Devices (Charger Not Included)
  • Sleek 7-in-1 USB-C Hub: Features an HDMI port, two USB-A 3.0 ports, and a USB-C data port, each providing 5Gbps transfer speeds. It also includes a USB-C PD input port for charging up to 100W and dual SD and TF card slots, all in a compact design.
  • Flawless 4K@60Hz Video with HDMI: Delivers exceptional clarity and smoothness with its 4K@60Hz HDMI port, making it ideal for high-definition presentations and entertainment. (Note: Only the HDMI port supports video projection; the USB-C port is for data transfer only.)
  • Double Up on Efficiency: The two USB-A 3.0 ports and a USB-C port support a fast 5Gbps data rate, significantly boosting your transfer speeds and improving productivity.
  • Fast and Reliable 85W Charging: Offers high-capacity, speedy charging for laptops up to 85W, so you spend less time tethered to an outlet and more time being productive.
  • What You Get: Anker USB-C Hub (7-in-1), welcome guide, 18-month warranty, and our friendly customer service.
dontstarve_dedicated_server_nullrenderer -console -cluster MyClusterName -shard Caves

Replace MyClusterName with the exact destination folder name. The -shard value must match the corresponding directory name. If your configured shard directories have different names, use those names consistently in both the filesystem and commands.

Surface-only worlds

If the source is genuinely overworld-only, launch the surface shard and do not invent a caves directory. Keep the structure that the source save actually provides. A missing caves shard is different from a caves world whose folder was copied under the wrong name.

Worlds with caves

Run both shard processes for a multi-shard world. Each process uses the same cluster name, but each selects its own shard. Starting the surface with one cluster name and caves with another creates two unrelated contexts rather than one connected world.

Managed control panels

A managed host normally exposes the same concepts through file management and startup fields: persistent-storage location, configuration directory, cluster name, and shard name. Upload into the cluster selected by those fields, not merely into a directory visible in the file browser. If the panel hides the command line, confirm which folder and shard each startup profile selects before replacing files.

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

Verify the migration before deleting the source

Start the destination and join it only after both required shard processes are running. Verify the world in a deliberate order:

  1. Check that the server opens the expected cluster and accepts the intended token.
  2. Confirm the day count is the value from the source, not Day 1.
  3. Visit recognizable structures, landmarks, or bases that existed in the source.
  4. Check inventories, containers, equipment, and player identities.
  5. Enter a cave entrance and confirm the caves shard contains the expected map and structures, if the source used caves.
  6. Restart the server once and confirm the same state returns after saving.

Keep the original source and destination backup until these checks pass. Only then should you remove obsolete copies or automate restarts around the new cluster.

Convert an overworld-only client save

An overworld-only client save may not have the complete cluster structure used by a dedicated server. Klei forum guidance describes a conversion involving the client’s saveindex and the session directory identified by the world’s session_id. Treat this as a separate migration, not as a partial version of the direct-copy method.

Rank #4
Sale
UGREEN USB to USB C Adapter Combo 4-Pack, 10Gbps USB C Converter Space Gray
  • Dual Converters, Infinite Potential:Includes 2× USB C male to USB A female adapters and 2× USB A male to USB C female adapters. Perfect for a wide range of uses—tablets with Bluetooth keyboards, expand USB ports on macbook, and more. Two different converters for all your daily needs
  • Next-Level 10Gbps & 3A Charging: No more slow 480Mbps, this usb to usb c adapter has a transfer speed of up to 10Gbps, allowing you to do more transferring in less time. This usb adapter fits both USB A and USB C charger, supporting up to 3A fast charging
  • Upgraded Exquisite Craftsmanship: With an aluminum alloy housing and metal connector, the usbc to usb adapter is extremely durable and sturdy. Rigorously tested to withstand more than 10,000 times of plugging and unplugging, ensuring long-lasting performance
  • Broad Compatible: The usb c to usb adapter widely supports all USB C/ USB A devices like laptops, tablets, cellphones, car chargers, and phone chargers. Such as compatible with MacBook Pro/Air 2023/2022, Thunderbolt 4/3 Devices,Apple MagSafe Watch 9/8/7/SE/Ultra, iPad Pro 2022/2021, Samsung Galaxy S23/S20/S10, and iPhone 17/16/15 Pro. Plug and play
  • Please Note: To reach 10Gbps speed, keep the cable under 3.3 ft. For USB A Male to USB C adapters, try flipping the USB C connector. USB C Male to USB A adapters support bidirectional 10Gbps transfer within 3.3 ft

1. Make a backup and identify the slot

Back up the client save and the destination’s generated cluster before editing anything. Open the client’s client_save/saveindex and identify the slot that corresponds to the world you intend to move. Selecting the wrong slot can produce a valid-looking but unrelated world.

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.

2. Place the selected save index

Set the appropriate slot in the client save index, then place the resulting saveindex under the dedicated server’s Mastersave directory (use the equivalent separator on Linux). The server’s current generated structure determines the exact case and nesting; preserve those names rather than creating a parallel path.

3. Copy the matching session directory

Read the world’s session_id from the save data and locate the session directory with that same identifier. Copy that directory into the dedicated server’s savesession directory under the Master shard. The identifier must match; copying an arbitrary session directory does not attach the intended world.

4. Reconcile the cluster configuration

Ensure the destination cluster still has its own cluster.ini, token, and required server settings. Do not overwrite those with unrelated files from another cluster. Because this conversion adapts client-generated data to a server-generated layout, names may need to be adjusted to the current server structure.

5. Start, test, and roll back if necessary

Launch the Master shard using the destination cluster name and test the day count, structures, inventories, and player identities. If the result is Day 1 or a fresh map, stop immediately and restore the backup before trying another slot or session directory.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Troubleshoot a fresh Day 1 world

A Day 1 start or an empty map is a diagnostic signal, not a reason to keep experimenting on the live copy. Stop the server, preserve the failed directory for comparison, and check these causes in order.

The cluster path is wrong

Compare the folder named by -cluster with the directory that contains cluster.ini. Then compare both with the active -persistent_storage_root and -conf_dir values. A correct save in an unused directory has no effect on the running process.

Best Value
Sale
Anker USB C Hub, 5-in-1 USBC to HDMI Splitter with 4K Display | 85W Max PD, 1 Powered USB-C 5Gbps & 2 Powered USB-A 3.0 5Gbps Data Ports, for MacBook Pro, MacBook Air, Dell and More (Black)
  • 5-in-1 Connectivity: Equipped with a 4K HDMI port, a 5 Gbps USB-C data port, two 5 Gbps USB-A ports, and a USB C 100W PD-IN port. Note: The USB C 100W PD-IN port supports only charging and does not support data transfer devices such as headphones or speakers.
  • Powerful Pass-Through Charging: Supports up to 85W pass-through charging so you can power up your laptop while you use the hub. Note: Pass-through charging requires a charger (not included). Note: To achieve full power for iPad, we recommend using a 45W wall charger.
  • Transfer Files in Seconds: Move files to and from your laptop at speeds of up to 5 Gbps via the USB-C and USB-A data ports. Note: The USB C 5Gbps Data port does not support video output.
  • HD Display: Connect to the HDMI port to stream or mirror content to an external monitor in resolutions of up to 4K@30Hz. Note: The USB-C ports do not support video output.
  • What You Get: Anker 332 USB-C Hub (5-in-1), welcome guide, our worry-free 18-month warranty, and friendly customer service.

The cluster name differs by spelling or case

The command value and folder name must match. Correct a typo, extra space, or case difference, then restart. Do not create a second folder as a workaround; that can leave two plausible-looking clusters and make future recovery harder.

A shard directory or argument is mismatched

Confirm that the surface command selects Master and the caves command selects Caves, or that both use the exact custom names in your files. A caves folder copied as a differently named directory will not be selected by -shard Caves.

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.

Only part of the cluster was copied

Check that cluster.ini is at the cluster root, not inside Master or Caves, and that each shard directory was copied completely. Restore the destination backup and repeat the copy if files were omitted.

The client conversion used the wrong slot or session

For an overworld-only save, recheck the slot in saveindex and verify that the copied session directory’s name equals the world’s session_id. Keep the original client files unchanged while testing alternatives.

The server is reading a different generated structure

Some client-only migrations require placing files inside the destination server’s existing Mastersave and savesession directories rather than beside them. Compare the destination’s generated folders with the conversion instructions and adjust only the backed-up copy.

Permissions prevent reading or writing

Verify access for the account that runs the server process. The process needs to read the copied configuration and shard data and write new saves. Correct access, then restart from the backed-up cluster.

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

A migration checklist

  • Destination processes stopped before any files were replaced.
  • Destination cluster and source world backed up separately.
  • Active persistent-storage root and configuration directory identified.
  • -cluster value matched the destination folder.
  • cluster.ini placed at the cluster root.
  • Master copied completely.
  • Caves copied completely when the source uses caves.
  • server_token.txt placed in the cluster root.
  • Source server settings, mod configuration, and world-generation overrides retained where required.
  • Surface and caves processes started with the same cluster name and matching shard names.
  • Day count, structures, inventories, player identities, and caves behavior verified.
  • Server restarted once successfully before the old source was retired.

Which approach is safest?

Situation Best choice Why
You have a complete cluster with cluster.ini and shard folders Direct copy with a rollback backup It preserves the server’s native cluster layout and requires the fewest transformations
You have only a client overworld save Manual saveindex/session_id conversion The client data may not contain a ready-to-launch dedicated-server cluster
The world includes caves Copy both shards and launch both processes The surface and caves are separate shards in one cluster
You use self-hosted SteamCMD Inspect and edit the actual launch commands You can verify every path and argument directly
You use managed hosting Use the panel’s file manager and startup profile together The visible upload directory may differ from the cluster selected at launch
You cannot tolerate data loss Backup-first migration and immediate rollback on Day 1 It limits experimentation to copies rather than the only world

What to remember

The decisive detail is not where the files exist; it is which cluster and shard paths the server launches. A complete migration keeps cluster.ini at the cluster root, keeps shard data inside consistently named Master and Caves directories, and starts every process with matching values. Client-only overworld saves require the additional saveindex and session_id conversion. When the server shows Day 1, stop, verify the path and names, and restore the backup before making another change.

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.

Leave a Reply

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

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
Windows Errors? Fix Them Before They SpreadFree repair scan
Crashes, No Sound, or Screen Glitches?Free driver scan

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.