Installation

This guide explains how to install and run Cobalt on your own VPS / VDS.

Requirements

Operating system

The following operating systems are supported. Other distributions are not officially supported and may not work or may require manual adjustments to the installer.

OS	Supported versions
Ubuntu	22.04 LTS or newer
Debian	13 (Trixie) or newer

---

Public IP address

A static public IPv4 address is required so the dashboard and game servers are reachable from the internet. A dynamic IP may work but is not recommended for production use.

---

git

Required for cloning the Cobalt repository.

Ubuntu

apt install git

Debian

apt install git

Quick start

1. Open CMD / Terminal.

2. Connect to the server via SSH:

ssh root@<server_ip>

TIP

If this is your first attempt, you will be prompted to enter "yes".

3. Enter the server password.

TIP

The letters won't appear as you type, but that's normal.

4. Clone the repository:

git clone https://github.com/artorias-developer/cobalt

5. Navigate to the project directory:

cd cobalt

6. Make the installer executable:

chmod +x build/scripts/install.sh

7. Run the installer:

./build/scripts/install.sh

The installer will ask you for some details, and then it will take care of everything automatically.

Dashboard access

A link to the dashboard and login credentials will be displayed after installation.

WARNING

Since the certificates are self-signed, you'll see a security warning the first time you open the dashboard. Click Advanced and then Proceed to <server_ip> (unsafe).

WARNING

Change the default password immediately after your first login to keep your dashboard secure.