Connecting your server

01Before you start

You need your server's IP, console port and console password. Your server host shows these in their control panel. You also need to be signed in with Discord and have linked your in-game name.

02Adding your server

1. 1Go to Connect Your Server (it is on the home page, the Servers page and the Manage page).
2. 2Press Add Your Server, or Add New Server if you already have one.
3. 3Fill in the Server IP, Console Port and Console Password exactly as your host gives them. The port has to be a number between 1 and 65535.
4. 4Optional: add a Label. This is a private nickname that only you see.
5. 5Press Connect Server.

Surge then tries to talk to your server. If it gets an answer, the server is saved, you get the message "Server connected. Admin dashboard unlocked." and you are taken to your Servers page. If it cannot reach the server, nothing is saved and you see the error so you can fix the details and try again.

03What connected means

Connected means the bot is talking to your server right now. That is what lets features run, events fire, messages go out and the dashboard show live numbers.

Each server card on the Servers page shows a status badge next to the name, along with players and queue, map, FPS, uptime and entity count. These numbers refresh every couple of minutes. If you are the server owner and the server has Premium, the card also shows a live countdown of time left and the Due on date. Staff who are not the owner do not see that. During the 2 day grace period it switches to how long you have left to pay.

• connected: all good.
• error: Surge could not reach the server last time it checked. The card shows the error message underneath.

04If your server disconnects

Servers restart, hosts have hiccups, it happens. When the connection drops, the bot keeps trying to reconnect on its own, so after a normal restart you usually do not need to do anything.

While it is offline, anything that needs the server waits. Panels show Bot offline or tell you the server is offline, buttons like Start Now or Use my Location are blocked, and scheduled events hold off until the bot is back.

If it stays disconnected, the most common reason is that the console details changed, for example after you changed them at your host. In that case:

1. 1On your admin dashboard, press Manage servers next to Connect server.
2. 2Pick the server, then press Edit details.
3. 3Enter only what changed, usually just the new console password. If the server moved, open Server moved to a new IP or console port? and enter the new ones. Anything you leave empty stays as it is.
4. 4Press Save changes. Surge checks the new details first, and all of the server's data and settings stay exactly as they were.

05Removing a server

On your admin dashboard, press Manage servers, pick the server and press Delete server. The bot disconnects straight away, but the server is not gone yet. Surge keeps it saved for a while, with all of its data and settings.

• Free: your server is saved for 10 days.
• Premium: your server is saved for as long as you keep paying for Premium.
• Premium that has ended: if you had Premium and stopped paying, your server is saved for 15 days. This also counts when Premium ends after you deleted the server: you get 15 days from the day it ended.

If you add the server again in that time, your data is restored. Use Add New Server as normal and enter your console details. Surge recognises the server and brings it back exactly as you left it, with its settings, players and history. It does not matter if you changed the console password in the meantime.

Once that time runs out, the server and all of its data are erased for good and cannot be brought back.

06Inviting your players

Every server card has a Copy player link button. Share that link in your Discord. When players open it they sign in with Discord, link their in-game name, and your server is added to their favourites on the player dashboard. They never see every Surge server — only the ones they favourite, or they can search by name after typing two letters.