explain autobuilds
[xonotic/xonotic.wiki.git] / local-test-server-on-gnu-linux.md
1 This tutorial explains how to setup a local test server that can be launched on the same machine as client.
2
3 # Official release
4
5 This section explains how to setup a server from the official release of Xonotic. It assumes that you have extracted it in `~/Games/Xonotic/Release`.
6
7 First you need to create a file called `~/.xonotic/data/server.cfg` with the following content:
8
9 ```
10 sv_public 1
11 hostname "My Test server"
12 maxplayers 32
13 ```
14
15 This config creates a vanilla deathmatch server that will be visible to other players on the server list.
16
17 Next, you will probably want to create a launcher for your server so you can launch it from your desktop. Create a file called `~/Desktop/Xonotic Server.desktop` with the following content:
18
19 ```
20 [Desktop Entry]
21 Version=1.0
22 Type=Application
23 Terminal=true
24 Exec=/home/user/Games/Xonotic/Release/xonotic-linux64-dedicated -sessionid 1
25 Name=Xonotic Server
26 Icon=/home/user/Games/Xonotic/Release/misc/logos/icons_png/xonotic_32.png
27 Path=/home/user/Games/Xonotic/Release/
28 ```
29
30 Now try double clicking on that launcher in your desktop and it should launch a dedicated server. Then you can launch client and connect to it.
31
32 # Git version
33
34 This section explains how to setup a server from the git repository of Xonotic. It assumes that you have cloned it in `~/Games/Xonotic/Git/xonotic`.
35
36 You can use `server.cfg` from the previous section.
37
38 Create a file called `~/Desktop/Xonotic Git Server.desktop` with the following content:
39
40 ```
41 #!/usr/bin/env xdg-open
42
43 [Desktop Entry]
44 Version=1.0
45 Type=Application
46 Terminal=true
47 Exec=/home/user/Games/Xonotic/Git/xonotic/darkplaces/darkplaces-dedicated -xonotic -sessionid 1
48 Name=Xonotic Git Server
49 Icon=/home/user/Games/Xonotic/Git/xonotic/misc/logos/icons_png/xonotic_32.png
50 Path=/home/user/Stuff/Games/Xonotic/Git/xonotic/
51 ```
52
53 Again, double click on this launcher to launch server. Have fun!