Installation
This guide explains how to install and run Cobalt on your own VPS / VDS.
Requirements
Operating system: Ubuntu 22.04 LTS or newer. Other distributions are not officially supported and may require manual adjustments to the installer.
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 to clone the Cobalt repository. Install it via apt install git if not already available on your system.
Quick start
Open CMD / Terminal.
Connect to the server via SSH:
ssh root@<server_ip>TIP
If this is your first attempt, you will be prompted to enter "yes".
- Enter the server password.
TIP
The letters won't appear as you type, but that's normal.
- Clone the repository:
git clone https://github.com/artorias-developer/cobalt- Navigate to the project directory:
cd cobalt- Make the installer executable:
chmod +x build/scripts/install.sh- Run the installer:
./build/scripts/install.sh --prod --server <server_ip>TIP
If you need to bind Cobalt to a port other than the default 443, you can add the --port <custom_port> option.
The installer will automatically install Docker and Docker Compose if not present, generate SSL certificates and all config files, build and start the containers.
Dashboard access
Your dashboard will be accessible at https://<server_ip>.
Credentials
Login: admin
Password: admin
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.