Deploy a Dedicated Server (Automated Setup)

Get a server

Get a Linux server (VPS) with a public IP address. Debian is recommended, but Ubuntu, Fedora, and Arch also work.

How much RAM you need depends on how many bots you plan to run:

When creating your server, choose the Debian image. Save the server's public IP address for the next step.

Connect via SSH

SSH (Secure Shell) lets you run remote commands on the server. Open a terminal on your computer and connect:

ssh root@your-server-ip

Replace your-server-ip with the IP address from the previous step. Enter the server password when SSH asks for it. You created this password when you created the server, or your provider sent it by email.

On Windows, use PowerShell or Windows Terminal. Both have SSH built in. On macOS/Linux, use the default terminal.

Run the setup script

After SSH connects, run this command:

wget -qO /tmp/sf-setup.sh https://raw.githubusercontent.com/soulfiremc-com/SoulFire/main/scripts/soulfire-dedicated-setup.sh && sudo bash /tmp/sf-setup.sh

The script asks you about these options:

• System updates and Docker installation, if required
• HTTPS setup with Cloudflared, Traefik, or plain HTTP
• SoulFire deployment with Docker Compose in /opt/soulfire/

Generate an access token

Run the same command again to open the management menu:

wget -qO /tmp/sf-setup.sh https://raw.githubusercontent.com/soulfiremc-com/SoulFire/main/scripts/soulfire-dedicated-setup.sh && sudo bash /tmp/sf-setup.sh

Select Attach to SoulFire console, then run:

generate-token api

Copy the token for the next step.

Connect the GUI client

Install SoulFire on your computer, then open it. Enter these values:

• Server URL: The configured HTTPS URL, such as https://your-domain.com or https://your-server-ip
• Access token: The token from the previous step

You are now connected to your dedicated SoulFire server.