Halloween DealsAmazon USHalloween week deals: useful picks before month-endAmazon US: current deals, useful picks and tech finds.Check DealsSlow PC?RecommendedPC slow today? Run a repair scan before it gets worseResolve common Windows issues and optimize system performance.Scan NowHalloween DealsAmazon USOctober picks are moving - compare before checkoutAmazon US: current deals, useful picks and tech finds.See Picks×
FREEDOM251

Freedom251 › Blog › Game Servers

How to Update Mods on a Terraria Server

By Freedom251 Team · · 11 min read

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.

To update a Terraria server safely, run it on tModLoader, stop the server, back up the world and mod configuration, update tModLoader and the installed mods using the same method used for installation, then restart and test with clients on the same tModLoader branch and mod versions. A running process will not load new binaries or mod files until it is restarted.

What a “mod update” actually changes

A dedicated tModLoader server has two separately changeable components:

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 tModLoader runtime: the server program that loads Terraria and its mods.
  • The mod set: Workshop downloads, local mod files, the enabled-mod manifest and each mod’s dependencies.

Updating only one component is sometimes the right troubleshooting step. If a new runtime causes errors, you may need to keep the previous runtime while updating individual mods. If a mod has a bug, you may need to update the mod without changing tModLoader. The official server utility provides separate operations for both cases as well as a combined update.

Operation What it updates When to use it
install tModLoader and installed mods Routine full update when the branch and mod set are expected to remain compatible
install-mods Mods only When the runtime is known to work and you are changing or refreshing mods
install-tml tModLoader only When testing a runtime change separately from mod changes

Players must also be on a compatible tModLoader branch and have matching mod versions. A server can start successfully while a client is rejected because the client is on a different branch, has a different enabled set or has not finished downloading a newly updated Workshop mod.

#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.

Prepare a safe maintenance window

Announce downtime and stop cleanly

Tell players when the server will be unavailable, then stop the server through its normal control method. Do not replace runtime or mod files while the process is still running or while players are saving characters and world data. New files are loaded on the next start, and replacing files during play can leave an incomplete update or a damaged world.

Back up every file needed for a rollback

Before changing anything, make a restorable copy of:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  • Every world file used by the server.
  • The complete Mods directory, including local mods.
  • install.txt, which lists Workshop items for installation.
  • Mods/enabled.json, which records the mods that should be activated.
  • The server configuration, launch arguments and any password or port settings.
  • For Docker, all host directories or volumes bind-mounted into the container, including worlds, manifests, configuration and mod data.

Keep the backup outside the directory that the update process will replace. Give it a date and record which copy is the pre-update state.

Record the current working state

Write down the current tModLoader branch or version, the enabled-mod list and any custom start options such as a non-default folder. This lets you identify exactly what changed and restore the prior state instead of guessing after a failed launch.

Choose the procedure that matches your installation

Use the method that originally installed the server. Mixing a package-managed installation with manual file replacement can leave the executable, libraries and mods on different versions.

  • Official Dedicated Server Utils script: use this for installations obtained through SteamCMD or GitHub.
  • Docker: rebuild the image and keep persistent Terraria data on the host-mounted storage.
  • Manual or custom deployment: update the same runtime files and manifests you used originally, while preserving the backup and branch information above.

Update a SteamCMD or GitHub installation with the official script

The official Dedicated Server Utils documentation supports installing tModLoader from SteamCMD or GitHub. Run the commands from the directory containing manage-tModLoaderServer.sh, and use the account or permissions that normally run your server.

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

Update tModLoader and all installed mods

./manage-tModLoaderServer.sh install

This is the normal full-update command. It updates the runtime and then processes the mod installation and activation data available to the server.

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.

Update mods without changing the runtime

./manage-tModLoaderServer.sh install-mods

Use this when you want to refresh Workshop or local mod files while keeping the currently working tModLoader runtime. The command needs both of the server’s manifests to do useful work: install.txt tells it which Workshop mods to install, and Mods/enabled.json tells it which mods to enable. If those files are absent, the utility installs nothing or enables nothing.

Update only tModLoader

./manage-tModLoaderServer.sh install-tml

This isolates a runtime change. It is useful when a compatibility fix is required in tModLoader but you want to leave the mod files untouched while you test.

Start the server after the update

./manage-tModLoaderServer.sh start

Pass the same --folder option you used previously if the server lives in a custom location. Starting with a different folder can make a healthy update appear to have lost worlds or mods because the process is reading another data directory.

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

Check the two manifests before starting

Open install.txt and confirm that every intended Workshop item is present. Then inspect Mods/enabled.json and confirm that every mod you want active is listed. The enabled file must include the complete enabled set, including local mods; a local file that is present but absent from the manifest will not load merely because it is in the directory.

Update a Docker server

For a Docker deployment, updating the container definition and rebuilding the image is what retrieves newer tModLoader and mod files. From the directory containing your Compose file, run:

docker compose build

If the builder reuses an old layer or you need to guarantee a clean image, run:

docker compose build --no-cache

Do not treat the container filesystem as the only copy of your server. Before replacing or recreating the container, verify that worlds, install.txt, Mods/enabled.json, configuration and any other required data are in host-mounted paths or named volumes. Rebuilding an image does not protect data that existed only inside a disposable container layer.

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 | 6.35mm Jack, Durable Design, Stage and Home Studio Use, Low Noise Shielded Electric Cord for Bass, Keyboard, Amp, Mixer
  • [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

After the build completes, start the service using the same Compose configuration and confirm that the container is using the intended mounts, environment variables and port. A rebuild that points at an empty or different mount can produce a clean-looking server with none of your previous worlds or manifests.

Use a Workshop modpack as the server’s source of truth

Create or maintain the modpack on a tModLoader client

For a repeatable setup, maintain the desired collection in the tModLoader client, review additions and removals, and check dependency changes before applying it to the server. This gives you a deliberate list rather than relying on whatever files happen to be in a server directory.

Copy both manifest files

Copy the client’s install.txt and enabled.json into the server’s Mods area, using the exact filenames expected by the server utility. Keep the files together: install.txt controls Workshop installation, while Mods/enabled.json controls activation. Updating one without the other can download a mod that remains disabled, or enable a name that is not installed.

Review changes before applying them

  • Check which mods were added and whether their dependencies are also listed.
  • Check which mods were removed; removing a content mod can affect items, tiles or world data that still exist in a save.
  • Confirm that local mods are copied to the server and included in enabled.json.
  • Keep a copy of the previous manifests so a rollback restores the exact former set.

Start and verify the updated server

Read the complete startup log

Do not stop at the first “server started” message. Scan the log for missing dependencies, load exceptions, duplicate files, disabled mods and explicit version or branch mismatches. A server can open a port while silently skipping a mod that failed during loading.

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

Confirm the enabled set

Compare the startup list with your recorded pre-update list and the new manifest. Verify that expected mods appear once, that dependencies loaded, and that no obsolete duplicate file remains in the Mods directory.

Test with a controlled character

Join with a test character, enter the intended world and exercise content supplied by the updated mods: open a modded interface, use a representative item or interact with a modded tile or NPC. Keep players away from the production session until this check is complete. An update can load far enough to show the world and still fail when a particular content asset is used.

Have every player update before reconnecting

Ask players to launch the same tModLoader branch as the server and wait for Workshop or client downloads to finish before joining. A client with an old mod file, a missing dependency or a different enabled set may receive a mismatch error even though the server itself is healthy.

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.

Keep the client and server on compatible branches

tModLoader’s player guidance describes the default release as the appropriate choice for most users. Steam beta branches provide legacy and preview options when compatibility requires something other than the default.

Branch Purpose Use it when
Default release Current stable branch intended for normal play Your required mods support the current stable runtime
Legacy Older runtime retained for compatibility A required mod has not moved to the newest stable runtime
Preview Early branch for testing new features You are deliberately testing preview changes and accept that mods may not yet work

Set the server and clients to the same branch before diagnosing individual mod files. Changing only the server to a new branch can create a misleading cascade of “out of date” messages.

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

What Terraria 1.4.5 means for mod updates

Compatibility with Terraria 1.4.5 is still a moving target. The tModLoader team says the update changed enough that not all mods can work immediately, and states: “Due to how much has changed in the Terraria v1.4.5 update, the short answer to this is ‘no’.” In other words, do not assume that a mod working on 1.4.4 will load unchanged on 1.4.5.

The team has also said that the earlier 1.4.4 porting process took nine months. That figure is context for why a major Terraria update can leave a long compatibility gap; it is not a promise that any particular mod will be ready after a fixed period.

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

The 1.4.4 version and its mods remain available as a Legacy version with maintenance updates. If a required mod has not yet been ported, keep the server and every client on the documented Legacy branch instead of forcing a partially compatible stable or preview combination.

When Workshop downloads fail

tModLoader can still run when Steam cannot download Workshop content, but the affected mods must then be installed manually. First stop the server and preserve the manifests and backup. Obtain the exact mod files from a trusted, compatible installation source, place them in the server’s Mods directory, and ensure their names are represented in Mods/enabled.json. Check dependencies and the startup log before allowing players to join.

Manual installation does not remove the need for version matching. A manually copied file must correspond to the server’s branch and to the files used by clients; otherwise the connection will still fail with a version or content mismatch.

Troubleshoot common update failures

The server starts with no mods enabled

Check that Mods/enabled.json exists in the expected data directory and contains the complete enabled list. If you used a custom folder or Docker mount, verify that the process is reading that location rather than a new empty directory. Then confirm that the listed files are actually present.

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

Workshop mods were not installed

Check install.txt. The official utility does not know which Workshop items to install without it. Confirm that the file is in the expected server location, contains the intended entries and is included in the host-mounted data for Docker.

A dependency or load exception appears

Read the first dependency or exception message, not only the final shutdown line. Identify the named prerequisite, install or update it on the server, and make the same change on clients. If the required mod supports only an older runtime, switch the entire group to the compatible Legacy branch rather than mixing branches.

The log reports duplicate files

Stop the server and inspect the Mods directory for old and new copies of the same mod. Keep one intended version, restore the manifest that matches it and start again. Do not delete files while the server is running.

Clients receive a version or mod-list mismatch

Compare the server branch, client branch, enabled list and actual mod versions. Have the player finish Workshop downloads, remove an obsolete client copy if necessary, and relaunch tModLoader. If the server was updated to 1.4.5 while a required mod remains 1.4.4-only, return both sides to the compatible Legacy branch.

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

The updated server crashes or behaves incorrectly in-world

Stop accepting players, preserve the new log and restore the pre-update backup of the runtime, mod files, manifests and configuration. Re-enable the prior set and test with no players connected. A world backup is especially important when a content mod changed items, tiles or world-generation behavior.

Rollback after a failed update

  1. Stop the server and prevent players from reconnecting.
  2. Save the failure log so you can identify the incompatible component.
  3. Restore the previous tModLoader files, mod files, install.txt, Mods/enabled.json and configuration from the dated backup, or select the previously working Legacy branch.
  4. Restore the prior enabled order and set, including local mods.
  5. Start with the same world path and launch options as before.
  6. Read the startup log and run a short test with a test character before reopening the server.

Do not restore only the executable while leaving new manifests or mod files in place. A rollback is reliable only when the runtime, mod files, manifests and configuration describe the same known-working state.

A repeatable update checklist

  • Schedule maintenance and stop the server cleanly.
  • Back up worlds, the Mods directory, install.txt, Mods/enabled.json, configuration and Docker-mounted data.
  • Record the current branch, runtime version and enabled list.
  • Choose one update path: the official script, Docker rebuild or the same manual method used for installation.
  • Review manifest additions, removals and dependencies.
  • Update runtime and mods together, or deliberately use the separate operation needed for troubleshooting.
  • Start with the original folder, world path and configuration.
  • Inspect logs, confirm the enabled set and test modded content.
  • Have every client use the same branch and matching mod versions before reopening access.
  • Keep the dated backup until the new state has survived a normal play session.

Why this process prevents most “out-of-date mod” errors

Most update failures are coordination problems rather than a single bad download. The server needs a compatible runtime, installed files and an activation manifest; clients need the same branch and mod versions; and the process must restart before it can see new files. Backups and separate runtime/mod commands give you a controlled way to identify which layer changed. When a major Terraria release such as 1.4.5 is involved, selecting the documented Legacy branch is often safer than forcing every mod onto a runtime it does not yet support.

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.

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

Game ServersModsserver administrationTerrariatModLoader

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.

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.