View source for Guide:Dedicated Server

<languages />
<translate>
<!--T:1-->
'''Technical specs:'''<br>
Here's a rough, conservative estimate of the hardware requirements, assuming a normal survival world where players like to spread out. These are recommended values; with some tuning, the requirements can probably be lowered.

 <!--T:2-->
OS: Windows or Linux
 Memory: 1 GB base RAM + 300 MB per player
 CPU: 4 Threads recommended 
 Frequency: 1 GHz base + 100 MHz per player


== Dedicated server on Windows == <!--T:3-->

<!--T:4-->
Below is a detailed guide for creating a multiplayer server on a computer using Windows operating system.
</translate>
{{Messagebox
|width= 25%
|title= <translate><!--T:5--> Last verified for</translate>
|text= Windows 11 Home <br> 
<translate><!--T:6--> version 23H2</translate> <br> 
<translate><!--T:7--> 64-bit operating system</translate>
}}
<translate>

=== Install Vintage Story === <!--T:8-->

</translate>

{{Messagebox
|title= <translate><!--T:9--> Note</translate>
|text= <translate><!--T:10-->
When <code>(default)</code> appears before a piece of information, it's a reminder that the instructions need to be adjusted if the reader did not use the default settings. <br>
When <code>(example)</code> appears before a piece of information, it's a reminder that if the reader used the example provided earlier, then they should have the outcome displayed at this point.</translate>
}}
<translate>
<!--T:11-->
The default install location for Vintage Story is the Roaming folder of AppData.  If you copy-paste <code>%AppData%/Vintagestory</code> into the address bar of File Explorer and hit the {{keypress|Enter}} key, you should be directed to that folder (if it exists).  Presumably you already downloaded the game for singleplayer use and have updated to the latest version.

<!--T:12-->
When you install Vintage Story for singleplayer, you get more than one program file.  Inside (default) <code>%AppData%/Vintagestory</code> should be both Vintagestory.exe and Vintagestory''Server''.exe.

<!--T:13-->
If you intend to host from a computer separate than the one you play on, you also need to install the game on the host machine; the process is no different.  However, I'm going to refer to the singleplayer installation as <code>%AppData%/Vintagestory</code> and to the host installation as <code>%AppData%/VSserver</code>, regardless of whether the host is a separate machine.

<!--T:14-->
Reminder: Forum and game accounts are currently separate.  Log in to [http://account.vintagestory.at account.vintagestory.at] rather than [http://vintagestory.at vintagestory.at] to go directly to the downloads area.  

<!--T:15-->
Unless you specifically want to use an older version of the game, use the Recommended Download buttons.

=== Set data path === <!--T:16-->

<!--T:17-->
If you intend to host from the same machine that you play on, it's highly advisable to designate a separate area for the server data, so it doesn't get mixed up with your singleplayer data (save files, settings, etc).
If you're hosting on a separate machine, you can skip this section.  But keep in mind that the directions throughout this guide assume distinct file paths for singleplayer data and server data.

<!--T:18-->
'''Shortcut method:'''
# Navigate to the location where you will store the server's data, such as a new VSserver folder created in <code>C:\Users\YourUsername\AppData\Roaming</code><br><br>
# Create a folder for the server's data and give it a clear name, such as VSserverData<br><br>
# Open that folder and copy the entire path from the address bar of File Explorer.  (example: <code>C:\Users\YourUsername\AppData\Roaming\VintagestoryServer\VSserverData</code>)<br><br>
# Open the game's application folder; it is <code>%appdata%/VintageStory</code> by default.<br><br>
# Create a shortcut of <code>VintagestoryServer.exe</code>.  This can usually be accomplished through the right-click menu; google instructions specific to your operating system version if needed.<br><br>
# Open the Properties of the new shortcut.  This can usually be accomplished through the right-click menu.<br><br>
# Click in the Target field of the shortcut's Properties, then go to the very end of what's written there.  Add one space, then <code>--dataPath=</code>, then Paste the folder path you copied earlier, in quotes.  The entire contents of the Target field should now be something like this: <code>"C:\Users\YourUsername\AppData\Roaming\Vintagestory\VintagestoryServer.exe" --dataPath="C:\Users\YourUsername\AppData\Roaming\VintagestoryServer\VSserverData"</code> <br><br>
Optional: you can move/copy the shortcut, to your desktop and/or your new VintagestoryServer folder

<!--T:19-->
While the following tutorial is for using different versions of the game on a single machine, the latter half deals with setting a dataPath; skip to 2:57. 
</translate>
{| class="wikitable"
|-
! How do I...? by Shi No Hakobi-te 
|-
| <youtube width="200" height="120">lAeiF6ec6Sw?t=155</youtube> 
|}
<translate>

<!--T:20-->
'''Batch script method''' (functionally equivalent to the shortcut method above):
# To create a batch script, simply create a blank text document and rename it with the .bat file extension.  
# You can edit it by right clicking and selecting edit.  Then just type <code>%appdata%/Vintagestory/VintagestoryServer.exe --dataPath "[PATH]"</code>  replacing [PATH] with the desired path for the server's data, then save and close.  
Running the script will run the server with the alternate datapath, and will generate its own collection of config files there.  This is functionally equivalent to the modified link. 

<!--T:21-->
<br>
Next: 
* Run the ''shortcut you made'' of <code>VintagestoryServer.exe</code> or the batch script.  This should create an array of subfolders (such as Mods) inside the VSserverData folder.
* Close the server for now.

=== Configure router/firewall === <!--T:22-->

<!--T:23-->
Presumably you want to share a world with players who don't live at your address and use the same local network.  A firewall is a device or program that controls the flow of network traffic involving different security levels.  If you want the server to be accessible from outside of your local network, you need to configure your internet router to permit Vintage Story to use a port.  This is sort of like opening a door in your firewall, to let certain traffic through.  It's not a physical connection, but rather a set of information that directs the traffic.  

<!--T:24-->
As an example, Google Voice offers [https://en.wikipedia.org/wiki/Call_forwarding call forwarding], which lets you give people a Google-assigned phone number while keeping your personal SIM card number private.  You can change or cancel the Google Voice number without giving up your personal number assigned by your phone service provider.  Similarly, port forwarding directs internet traffic to a particular location in your network while keeping the details of that location hidden from people outside your network.

<!--T:25-->
The process for opening a port varies significantly and cannot be effectively detailed here.  Google "port forward" with your router's make and model for instructions.  Examples: "port forward TP-Link AC1200" or "port forward ASUS RT-AX1800S".

<!--T:26-->
[[File:Server router settings.png|500px|alt=Displays a screenshot of a webpage, with several fields awaiting info.|Router settings]]<br>
For the above example, here's what you should put:
</translate>

{{Messagebox
|width= 25%
|title= <translate><!--T:27--> Port Forwarding</translate>
|text= Name: Vintage Story<br>
<translate><!--T:28--> Global Port Range:</translate> 42420 - 42420<br>
<translate><!--T:29--> Base:</translate> 42420<br>
<translate><!--T:30--> Protocol:</translate> TCP
}}
<translate>
<!--T:31-->
While <code>TCP/UDP</code> ''shouldn't'' prevent TCP from working, change the dropdown selector to ''just'' TCP.

<!--T:32-->
'''For version 1.20''' onwards, repeat the above process for UDP protocol.

<!--T:33-->
While permanently open ports, like a 24/7 game server, are more prone to experience malicious efforts such as port scanning bots and brute attack bots than temporarily open ports, the risk is minor.  

<!--T:34-->
By the way: configuring the router can happen ''after'' launching VintagestoryServer.exe unless you want to advertise to the master server.

=== Run VintagestoryServer.exe === <!--T:35-->

<!--T:36-->
If you set a new dataPath, instead run the shortcut you made of VintagestoryServer.exe or the batch script.
If Windows Firewall asks for permission, grant any necessary access.
A console should open, with white text on a black background.  If it closes right away, you might have another instance of Vintage Story already running; close that and try again.<br>
[[File:Server console example.png|500px|alt=Displays a black window with while text, detailing the server's loading processes|Server console]]

<!--T:37-->
You don't need to understand everything that's printed in the console, but do skim it. A message along the lines of <br><code>DATE TIME [Server Event] Dedicated Server now running on Port 42420 and all ips!</code> <br>is a good indicator that the server is ready for players to log in.

=== Share IP address with playerbase === <!--T:38-->

<!--T:39-->
An IP address (Internet Protocol address) is a numeric label assigned by your internet service provider. While it's not risky to give your home address or phone number to most people, some are malicious or will sell your data.  Similarly, it's good to be selective about who you share your IP address with: don't post it publicly on the internet in conjunction with identifying personal information.  Do give it to friends you want to spend time with, and to Vintage Story community members (staff or volunteers in the Discord server) assisting with technical issues.  Your IP address won’t give away sensitive information like your phone number or exact location.  

<!--T:40-->
One possible reason for recommendations to censor your IP address is that if the person(s) who set up your router left the password etc the default, somebody outside your network could potentially access your devices; anybody can google the default password for your router model, given enough time and determination.  If your router password is ''not'' the default anymore, there's very little risk in sharing your IP address.

<!--T:41-->
Simply googling "what's my IP" will yield several sites providing your public IP address.  Unless you pay for a static IP address, your IP address will likely change a few times over the course of your server's lifetime.  If players suddenly become unable to connect to your server, re-google your IP address and provide players with the new number.

<!--T:42-->
Public IP, also known as an external IP, is the address provided by your internet service provider. Devices on the same network share this IP address when accessing the internet. For specific details, such as location, you can perform an IP lookup check. On the other hand, private, or local, IPs are assigned to each device on your network by your router.

=== Add server to Multiplayer menu === <!--T:43-->
</translate>

{|
| [[File:Menu Multiplayer button.png|200px|thumb|alt=Displays a pop-up listing no recent servers.|<translate><!--T:44--> Multiplayer world list (empty)</translate>]] 
| [[File:Menu AddNewServer.png|200px|thumb|alt=Displays a pop-up with 3 fields that have been filled with example information|<translate><!--T:45--> Add New Server options</translate>]] 
| [[File:Menu FavoriteServerList.png|200px|thumb|alt=Displays a pop-up with one world ready to load.|<translate><!--T:46--> Multiplayer world list (with 1 world)</translate>]]
|}

<translate>
<!--T:47-->
# From the main menu, select Multiplayer.  You might already have some servers listed that you joined previously.  
# Click the Add new server button.  
## Give your server a name; you can easily change it later.  
## In the next field, put your IP address.  In most cases, you do ''not'' need to put the port number after the IP address.  
## The password field is irrelevant unless the host set a password (see [[Guide:Dedicated_Server#Set protections]]).  
## Save by clicking the Create button.
# The server will now be added to the shortlist of multiplayer worlds.  Click the name of the server to join. 

<!--T:48-->
For any friends who wish to join, they need to complete these same steps, except they need to put the host's IP address rather than their own.  It's not important if the name they give the server matches the name the host gave it.  

<!--T:49-->
When they click the name of the server to join, they'll be prompted to download the server's modlist.  If they Accept, the entire list of server-side and universal mods will be added to a subfolder in the VintageStoryData\ModsByServer folder on their machine; they can add client-side mods to that subfolder if desired.

=== Set protections === <!--T:50-->

<!--T:51-->
It's highly advisable to put measures in place to prevent people with bad intentions from being able to harm your world.
You can do this via commands in the console or (if you have admin permissions) the in-game chat overlay, or by editing the serverconfig.json file, located in (Example) <code>C:\Users\YourUsername\AppData\Roaming\VintagestoryServer\VSserverData</code>.

<!--T:52-->
Serverconfig changes do not take effect until the server is relaunched.  When you've put in place all of the strategies desired from the suggestions below, save the serverconfig.json file or do <code>/autosavenow</code>.  Then do <code>/stop</code> and relaunch Vintagestoryserver.exe

==== Don't advertise ==== <!--T:53-->

<!--T:54-->
If you don't want strangers to join, you might as well prevent your server showing in the list when somebody selects "Browse public servers".
* Edit serverconfig.json: Change <code>"AdvertiseServer": true,</code> to <code>"AdvertiseServer": false,</code>.  Be sure to end the line with a comma.  
OR
* Run a command: <code>/serverconfig advertise false</code>.  

==== Set a password ==== <!--T:55-->

<!--T:56-->
* Edit serverconfig.json: Change <code>"Password": null,</code> to <code>"Password": "thisisnotastrongpw",</code>.  Be sure to enclose the password with quotation marks and end the line with a comma.
OR
* Run a command: <code>/serverconfig password thisisnotastrongpw</code>.  No spaces permitted.  
* Tell the password to your friends.  They should open the settings for your server (click the pencil icon next to the server name in Multiplayer menu) and type it in the Password field, then Save.

==== Use a whitelist ==== <!--T:57-->

<!--T:58-->
Only individuals added to a "whitelist" will be able to connect to the server.  Similarly, a blacklist prevents specific people or mods.
As of game version 1.20, dedicated servers use whitelisting by default, while single player worlds open to LAN (local area network) do not.  

<!--T:59-->
* Get the exact spelling of your friends' usernames for the game; the quickest place to find it is the bottom-left area of the game's main menu.  For each friend, run this command: <code>/player [username] whitelist on</code> (replace [username] with their username and don't type the brackets).  The server does not need to be restarted after whitelisting an individual.  
* It's impractical to whitelist via json file.
<br>
Disabling the whitelist is risky; it's significantly more secure than a password and removing your server's information from the public list.  But here's how it works:
* Edit serverconfig.json: Change <code>"WhitelistMode": "default",</code> to <code>"WhitelistMode": "off",</code>.  Be sure to end the line with a comma.  
OR
* Run a command: <code>/serverconfig WhitelistMode [off|on|default]</code>
"Default" means whitelist is ''on'' for dedicated servers, but ''off'' for single player open to LAN servers. 
<br><br>
If your server runs a game version ''before'' 1.20:
* Edit serverconfig.json: Change <code>"OnlyWhitelisted": false,</code> to <code>"OnlyWhitelisted": true,</code>.  Be sure to end the line with a comma.  
OR
* Run a command: <code>/serverconfig onlywhitelist true</code>.
For version 1.20 onwards, the serverconfig "OnlyWhitelisted" is obsolete.

==== Change default role ==== <!--T:60-->

<!--T:61-->
Instead of default survival player abilities, somebody who joins will only have the abilities described by the role you assign.  ''Suvisitor'' role "can only visit this world and chat but not use/place/break anything."
* Edit serverconfig.json: Change <code>"DefaultRoleCode": "suplayer",</code> to <code>"DefaultRoleCode": "suvisitor",</code>.  Be sure to enclose the role with quotation marks and end the line with a comma.  
* Run a command: A command to set the ''default'' role code is not currently available.  To adjust a player's role from suvisitor to full suplayer, do <code>/player [username] role suplayer</code> (replace [username] with their username and don't type the brackets).  You can do this while they are online or offline.  The server does not need to be restarted after changing somebody's role.
<br>
Reminder: save changes and relaunch the server for the changes to take effect.

=== Common errors === <!--T:62-->

<!--T:63-->
See [[Troubleshooting_multiplayer#Dedicated_server]].

=== Customize world === <!--T:64-->

<!--T:65-->
For a number of reasons, it's widely considered easier to create a custom world via the singleplayer Customize menu than via the serverconfig.json file.  Once the save file is created, copy-paste it (while the server is stopped) into the dataPath set up earlier: (example) <code>Roaming\VintagestoryServer\VSserverData\Saves</code>.  Then, either rename the save file to <code>default.vcdbs</code>, or edit the serverconfig.json file: change <code>"SaveFileLocation": "./data/Saves/default.vcdbs",</code> to <code>"SaveFileLocation": "./data/Saves/YourWorldNameHere.vcdbs",</code>

<!--T:66-->
See [[Preset_playstyles]]

=== Add/remove mods === <!--T:67-->

<!--T:68-->
Assuming that you set a custom data path (such as <code>%AppData%/VSserverData</code>) and launched the server, there should now be a Mods folder within <code>%AppData%/VSserverData</code>.  

<!--T:69-->
Inside <code>%AppData%/VSserverData</code> should also be a serverconfig.json file, which can be edited with a program such as Notepad++.  The ModPaths key indicates where the server should look for mods to load.  For instance,
</translate>
 "ModPaths": [
    "Mods",
    "\\AppData\\VSserverData\\Mods"
  ],/
<translate>

<!--T:70-->
'''Option 1)''' <br> You can download/paste mod zip files into <code>%AppData%/VSserverData/Mods</code>.  This is best done while the server is offline.  Changes made will take effect when the server is re-launched.<br> 
'''Option 2)''' <br> You can use commands to install/remove mods, or to list currently-installed mods.  See [[List_of_server_commands#/moddb]].

<!--T:71-->
<br> When a player attempts to join your server, they will be prompted to download your list of mods.
Only mods that are tagged as Server-side or Universal will be auto-downloaded in this way.  Client-side mods would need to be manually added by the player to the server-specific subfolder within (default) <code>%AppData%/VintagestoryData/ModsByServer</code>.


=== Gain admin powers === <!--T:72-->

<!--T:73-->
When you join your newly-created server, you should have default privileges of a survival player (role code suplayer).  If you want to have access to creative mode etc, you'll need to either change your role or grant yourself specific privileges.  Since suplayer role can't manage privileges, you'll need to either run the commands in the console, or edit the serverconfig.json file.
See [[List_of_server_commands#Privilege_Control]]
</translate>
{{Messagebox
|width= 25%
|title= <translate><!--T:74--> The above guide by:</translate>
|text= [http://discordapp.com/users/542024703468896306 T.Read], <translate><!--T:75--> July</translate> 2024
}}
<translate>

== Dedicated server on Linux == <!--T:76-->

<!--T:113-->
: ''This section is for x64 processors; if using ARM, please refer to the {{ll|Guide:Dedicated Server#Dedicated Servers on ARM64|ARM section}} below.''

<!--T:77-->
This describes how to set up the server as a service on Linux systems. It is focused on the technical differences in installation. Please read the Windows section above for more details on configuring the server settings.

</translate>
{{Messagebox|title=<translate><!--T:114--> This tutorial assumes you are using Bash.</translate>|text=<translate><!--T:115--> The '$' symbol indicates a command to run in your terminal.</translate>}}
<translate>

=== Requirements === <!--T:78-->

<!--T:116-->
* [https://dotnet.microsoft.com/en-us/download/dotnet/8.0 .NET Runtime 8.0]. If you don't have it installed, see {{ll|Installing_the_game_on_Linux#Installing_.NET_manually|how to install .NET manually}}.

<!--T:117-->
''Recommended:''

<!--T:118-->
* The ability to create a different user account to run the server under.
* To use the included convenience script for running and operating the service in the background, you will need to install <code>pgrep</code> and <code>screen</code> with your system's package manager. Below are instructions for some common distributions:

<!--T:148-->
{{Messagebox|title=Note that pgrep is part of the procps package on most distributions; Use the name procps instead of pgrep when installing.|text=Some distributions use the package procps-ng instead.}}

<!--T:149-->
: ''Debian/Ubuntu/Mint''
</translate>
 $ sudo apt update && sudo apt install procps screen
<translate>
<!--T:150-->
: ''Red Hat/Fedora''
</translate>
 $ sudo dnf install procps-ng screen
<translate>
<!--T:151-->
: ''Arch Linux''
</translate>
 $ sudo pacman -Syu procps-ng screen
<translate>
<!--T:152-->
: ''SUSE/openSUSE''
</translate>
 $ sudo zypper install procps screen
<translate>

=== Create a non-root user === <!--T:119-->

</translate>

{{Messagebox|bgcol=rgba(100, 30, 30, 255)|title=<translate><!--T:120--> For security reasons, it is STRONGLY RECOMMENDED to NEVER run the server as the root user.</translate>|text=<translate><!--T:121--> Do not use your personal account if you are running the server on your personal computer.</translate>}}

<translate>

<!--T:82-->
On most Linux operating systems, you can create a user with the command <code>useradd</code>.

</translate>
 $ sudo useradd vintagestory -m
<translate>

<!--T:122-->
Now, log in to the new user account.

</translate>
 $ sudo su -l vintagestory
<translate>

<!--T:123-->
This will place you in the vintagestory user's home directory as if you had logged in normally. You will not need to leave the home directory for the remainder of this tutorial.

=== Download the server software === <!--T:85-->

<!--T:124-->
1. First, go to [http://account.vintagestory.at/downloads the game client download page].

<!--T:125-->
2. Click "Show all available downloads and mirrors of Vintage Story".
</translate>
<div class="mw-collapsible mw-collapsed">
<translate><!--T:126--> ''Click ''<code>[Expand]</code>'' to display an image of this step.''</translate>
<div class="mw-collapsible-content">
<gallery widths=1100 heights=550>File:website-downloads-page-show-all-downloads.png</gallery>
</div>
</div>

----

<translate>
<!--T:127-->
3. Find the newest link that says "Linux tar.gz Archive (server only)". It should be the fifth link in the list.
</translate>
<div class="mw-collapsible mw-collapsed">
<translate><!--T:128--> ''Click ''<code>[Expand]</code>'' to display an image of this step.''</translate>
<div class="mw-collapsible-content">
<gallery widths=440 heights=260>File:website-downloads-page-hover-over-server-download-link.png</gallery>
</div>
</div>

----

<translate>
<!--T:129-->
4. Right click on the link, then select "Copy link".
</translate>
<div class="mw-collapsible mw-collapsed">
<translate><!--T:130--> ''Click ''<code>[Expand]</code>'' to display an image of this step.''</translate>
<div class="mw-collapsible-content">
<gallery widths=440 heights=420>File:website-downloads-page-right-click-copy-download-link.png</gallery>
</div>
</div>
<translate>

<!--T:131-->
----

<!--T:132-->
5. Paste the link into the terminal and download it with your preferred tool, such as <code>curl</code> or <code>wget</code>.

<!--T:153-->
For example, with <code>wget</code>, you would type in <code>wget</code>, press {{Keypress|Space}}, then press {{Keypress|Ctrl + Shift + V}} to paste the link.

</translate>
 $ wget <{{Keypress|Ctrl + Shift + V}}>
<translate>

<!--T:154-->
It should look like this:

</translate>
 $ wget <nowiki>https://cdn.vintagestory.at/gamefiles/stable/vs_server_linux-x64_<version>.tar.gz</nowiki>
<translate>

<!--T:155-->
If you are using <code>curl</code>, you will need to add the <code>-O</code> option.

</translate>
 $ curl -O <nowiki>https://cdn.vintagestory.at/gamefiles/stable/vs_server_linux-x64_<version>.tar.gz</nowiki>
<translate>

<!--T:156-->
6. Extract it to the <code>server</code> directory.

</translate>
 $ mkdir server && tar -C server -xzf vs_server_linux-x64_*.*.*.tar.gz
<translate>

<!--T:157-->
7. Optionally, you may delete the archive if desired.

</translate>
 $ rm vs_server_linux_*.*.*.tar.gz
<translate>

<!--T:158-->
8. Make sure the <code>server.sh</code> script is executable.

</translate>
 $ chmod +x server/server.sh
<translate>

=== Configuring the server === <!--T:133-->

<!--T:92-->
Now, you need to make sure the server will run using your desired username and data directory. Open the file <code>server/server.sh</code> in your preferred text editor. If you don't have one, you can use <code>nano</code> (you may need to install it via your package manager) with <code>nano server/server.sh</code>. After editing the file, press {{Keypress|Ctrl + X}}, then {{Keypress|Y}}, then {{Keypress|Enter}} to save and exit. If you already have a preferred editor configured, you may omit the EDITOR argument.

<!--T:134-->
Use the following values if you're following this tutorial. Using this specific data path is not necessary, but keeping it near the server files is convenient.

</translate>
 USERNAME=vintagestory
 VSPATH=/home/vintagestory/server
 DATAPATH=/home/vintagestory/data
<translate>

<!--T:135-->
If you will be using {{ll|Adding mods|mods}}, you will need to add the path to the <code>Mods</code> directory in your server config at <code>data/serverconfig.json</code>. If you are using a different data path, use that instead of the one displayed below.

<!--T:136-->
: ''Do not remove the first Mods folder. It is necessary for loading the base game files.''

</translate>
 "ModPaths": [
     "Mods",
     "/home/vintagestory/data/Mods"
 ]
<translate>

=== Opening the firewall === <!--T:137-->

<!--T:138-->
: ''For port forwarding, see {{ll|Guide:Dedicated_Server#Configure_router/firewall|above}}

<!--T:139-->
Depending on your system's configuration, it may be necessary to add firewall rules to allow external connections.

</translate>
 $ sudo firewall-cmd --permanent --zone=public --add-port=42420/tcp
 $ sudo firewall-cmd --permanent --zone=public --add-port=42420/udp
 $ sudo firewall-cmd --reload

 $ sudo iptables -A INPUT -p tcp -m tcp --dport 42420 -j ACCEPT
 $ sudo iptables -A INPUT -p udp -m udp --dport 42420 -j ACCEPT

 $ sudo ufw allow 42420/tcp
 $ sudo ufw allow 42420/udp
<translate>

=== Running the server === <!--T:94-->

<!--T:140-->
: ''See  {{ll|Guide:Dedicated_Server#Set_protections|above}} for more details on configuring the server settings.''

<!--T:95-->
Running <code>server.sh</code> starts the server in the background with the user configured in the file. Note that if you want to run two servers, you will need to change the <code>SCREENNAME</code> option in the script.

</translate>
 $ server/server.sh start
<translate>

<!--T:96-->
Once the server has started, you will need to add yourself to the whitelist so you can log in. It is recommended to also give yourself admin privileges so you can run commands in-game.

<!--T:141-->
This should be the name of your Vintage Story game account that you use to log in when starting the game.

</translate>
 $ server/server.sh command "/whitelist add <username>"
 $ server/server.sh command "/op <username>"
<translate>

=== Cleanup and convenience === <!--T:142-->

<!--T:143-->
Once configuration is complete, it is recommended to disable logging in for the server user account.

</translate>
 $ sudo usermod vintagestory -s /sbin/login
<translate>

<!--T:144-->
For managing the server without logging in, you can configure <code>sudo</code> to allow running commands as the server user. It is recommended to add a new file under <code>/etc/sudoers.d/</code> instead of editing the base sudoers file. You may need to install <code>nano</code> via your package manager. If you already have a preferred editor configured, you may omit the EDITOR argument.

</translate>
 $ sudo EDITOR=nano visudo /etc/sudoers.d/vs_server
<translate>

<!--T:145-->
Add the following line. Then, press {{Keypress|Ctrl + X}}, then {{Keypress|Y}}, then {{Keypress|Enter}}.

</translate>
 <your username> ALL= (vintagestory) NOPASSWD :ALL
<translate>

<!--T:146-->
You may now run commands as the vintagestory user without logging in with <code>sudo -u vintagestory <command></code>.

<!--T:147-->
To make running the <code>server.sh</code> script easier, create an alias:

</translate>
 $ echo -e '\n# Manage VS server\nalias vs_server="sudo -u vintagestory /home/vintagestory/server/server.sh $@"\n' >> ~/.bash_aliases && . ~/.bash_aliases
 $ vs_server
 Usage: /home/vintagestory/server/server.sh {start|stop|status|update|restart|setup ["user name"] ["path"]|command "server command"}
<translate>

<!--T:159-->
The server console can also be accessed directly with <code>screen</code>.

<!--T:160-->
{{Messagebox|title=If you changed the <code>SCREENNAME</code> option in the server script, use that name instead.}}

<!--T:161-->
While in the console, press {{Keypress|Ctrl + A}}, then {{Keypress|D}} to detach from it without closing the server.

</translate>
 $ sudo -u vintagestory screen -r vintagestory_server
<translate>

<!--T:162-->
Just like with the server script, an alias can be created to make this easier if desired.

</translate>
 $ echo -e '\n# Open VS server console\nalias vs_console="sudo -u vintagestory screen -r vintagestory_server $@"\n' >> ~/.bash_aliases && . ~/.bash_aliases
<translate>

== Dedicated Servers on ARM64== <!--T:100-->

<!--T:101-->
<span style="color:#E16100">Note: ''the ARM64 version is EXPERIMENTAL please report any issues to the [https://discord.com/channels/302152934249070593/1128220205181587516 discord ]''.

<!--T:102-->
As of {{Date|2024|12}}, no ARM64 .NET7 version of the ''MonoMod'' library is available. Harmony patching library depends on it. Therefore coded mods which use [[Modding:Monkey patching|Harmony patching]] ''will not work'' on an ARM64 server.  If a beta of the MonoMod library becomes available in future, server owners can try installing it for themselves.

<!--T:103-->
The ARM64 version is available on [https://github.com/anegostudios/VintagestoryServerArm64 GitHub].

<!--T:104-->
I recommend using the install script located on the GitHub. The following is a step by step guide on how to use the script on a Debian based system (Ubuntu, Debian, Rasbian, etc).

<!--T:105-->
1. Install the required dependencies to use this script by doing <code>apt -y install curl jq</code>

<!--T:106-->
2. Create a new file named <code>arminstall.sh</code> by running <code>vim arminstall.sh</code> or <code>nano arminstall.sh</code>

<!--T:107-->
3. Copy the contents of the <code>arminstall.sh</code> file from GitHub to your newly created file and save it by using <code>:wq</code> with Vim or <code>Ctrl + X</code>, then <code>Y</code>, then <code>Enter</code> with Nano.

<!--T:108-->
4. Make the script executable by running <code>chmod +x arminstall.sh</code>

<!--T:109-->
5. Run the script by doing <code>./arminstall.sh</code>

<!--T:110-->
6. Start the server by using <code>./VintagestoryServer</code> or <code>dotnet VintagestoryServer.dll</code>

<!--T:111-->
This will download the latest version of ''Vintage Story'' to the current working directory, then replace the needed files to work with ARM.

<!--T:112-->
If at any time you want to update to the latest version of ''Vintage Story'', simply run the script again.

</translate>

{{Game navbox}}

[[Category:Guides{{#translation:}}]]