Every Valheim Server Startup Argument (& the Permitted-List Trap)

Card listing the core Valheim dedicated server startup arguments.

 

    A Valheim dedicated server is configured almost entirely through startup arguments, and two details in Iron Gate's own documentation are worth knowing before you touch anything else: enabling crossplay removes the need for port forwarding entirely, and adding a single name to the permitted list bans everyone else from your server. Here is the full reference, the access-control files, and the traps.

 

The Core Arguments

 

ArgumentWhat it does
-nameThe server name shown in the browser
-port 2456Communication port — the server uses the specified port AND that port + 1
-world "Dedicated"The world name to create or load
-password "Secret"The server password
-public 11 = visible in the browser, 0 = join-code only
-crossplayEnables the PlayFab backend for cross-platform play
-preset hardWorld difficulty preset
-saveinterval 1800Save frequency in seconds — default 30 minutes

 

    Note the port behaviour. Setting -port 2456 opens 2456 and 2457. If you are running more than one server, space them by at least two.

 

    -saveinterval is worth lowering on a busy server. Thirty minutes is a long time to lose after a crash, and the argument takes plain seconds — -saveinterval 900 gives you fifteen minutes instead.

 

    On Linux, check your libraries. Iron Gate list minimums of GLIBC_2.29 and GLIBCXX_3.4.26. An older distribution will not start the binary.

 

Crossplay Removes Port Forwarding

 

Card explaining that crossplay routes through a relay and needs no port forwarding.

 

    This is the most useful thing in the whole guide, and it is easy to miss because it reads as a compatibility feature rather than a networking one:

 

With Crossplay enabled, "the server transmits data via a relay server and therefore does not require Port Forwarding to be accessible from outside of your local network."

 

    The Steam backend, by contrast, does require port forwarding on 2456–2457 to reach players outside your network.

 

    So -crossplay solves two problems at once: it lets PlayStation 5, Xbox and Nintendo Switch 2 players join alongside PC — all of which are on the platform list for 1.0 on 9 September — and it removes the router configuration that stops most self-hosting attempts.

 

    The trade is that you are routing through a relay rather than connecting directly, which is a latency consideration rather than a functional one. For a 1–10 player co-op world it is rarely the deciding factor.

 

    If you are self-hosting and stuck on connectivity, try -crossplay before you fight your router. It is a one-argument change.

 

Access Control: Three Files

 

Card explaining Valheim's adminlist, bannedlist and permittedlist files.

 

    Access is managed by three plain text files in the save directory:

 

FilePurpose
adminlist.txtGrants admin rights
bannedlist.txtBlocks specific players
permittedlist.txtRestricts the server to only the listed players

 

    The format is one Platform User ID per line, written as [Platform]_[User ID].

 

    And here is the trap, in Iron Gate's own words:

 

"Please note that adding a person on the permitted list will ban everyone else from the server."

 

    The permitted list is exclusive, not additive. Add one friend to test it and your entire group is locked out until you either add all of them or empty the file. This is the single most common way people accidentally take their own server offline.

 

    Use it deliberately or not at all. If you want a closed server, fill the list completely in one go. If you want an open one, leave the file empty and use -password instead.

 

    Where the files live:

 

OSPath
Windows%USERPROFILE%/AppData/LocalLow/IronGate/Valheim
Linux~/.config/unity3d/IronGate/Valheim

 

    That is also where your world saves are, which makes it the folder to back up before 9 September.

 

Preparing for 1.0

 

Card listing the pre-1.0 checklist for a Valheim server configuration.

 

    There is no public test branch for 1.0. Iron Gate confirmed "No. We want everyone to get to experience 1.0 at the same time!" — so the first time your server runs the new build is the moment it goes live for everyone, and nobody has rehearsed it, including mod authors.

 

    A short configuration checklist:

 

  1. Back up the entire save directory, not just the .db world file — that folder also holds your adminlist, bannedlist and permittedlist.
  2. Write your startup arguments down somewhere outside the server. If you have to rebuild, the fastest recovery is a clean server plus your old world and your old flags.
  3. Consider adding -crossplay now, since PS5 and Switch 2 join the platform roster at 1.0 and the argument also removes your port-forwarding dependency.
  4. Check your -saveinterval. A version-bump day is a bad day to discover it was still on the 30-minute default.
  5. Confirm your Linux libraries if you are self-hosting — GLIBC_2.29 and GLIBCXX_3.4.26 minimum.

 

    Remember the player cap does not change. Iron Gate confirmed 1.0 remains a game for 1–10 players, so no sizing decision follows from the update itself.

 

Practical tips

  • -port 2456 opens 2456 and 2457. Space multiple servers by at least two.
  • -crossplay routes through a relay and removes the port-forwarding requirement.
  • The permitted list is exclusive — one entry bans everyone else. Fill it fully or leave it empty.
  • Access files use [Platform]_[User ID], one per line.
  • Lower -saveinterval from its 30-minute default on an active server.
  • -public 0 hides the server; players join by code.
  • Back up the whole save folder before 9 September, not just the world file.

 

Running your own Valheim 1.0 server

 

    Every argument above is something managed hosting sets for you through a panel instead of a command line — and crossplay, the permitted list and save intervals are exactly the settings people get wrong once and then spend an evening undoing. A gamever Valheim server keeps your world online around the clock for the full 1–10 player group, applies the 9 September update automatically with a one-click backup taken first, and supports the complete crossplay roster including PlayStation 5 and Nintendo Switch 2.

 

Conclusion

 

    Valheim's dedicated server is configured through startup arguments-name, -port, -world, -password, -public, -crossplay, -preset and -saveinterval — with -port 2456 occupying both 2456 and 2457. The two details worth internalising are that -crossplay routes traffic through a relay and therefore removes the port-forwarding requirement entirely, which is the fastest fix for most self-hosting connectivity problems, and that permittedlist.txt is exclusive: "adding a person on the permitted list will ban everyone else from the server." Access files use [Platform]_[User ID], one per line, and live in the same folder as your world saves — which is the folder to back up before 9 September, since 1.0 ships with no public test branch.

 

    Want these set through a panel instead of a command line? Rent a Valheim server at gamever.io — instant setup, one-click backups and updates, full crossplay and 24/7 uptime. Start with a free trial and use promo code WELCOME.

Conquer the realms with your vikings. Your own Valheim server. Free with code WELCOME
Create serverStart hosting your server now
Knowledge Base