Start Here

Use this section to set up SoulFire for the first time. If you get stuck, ask in our Discord server.

Most users can start with Integrated server (local) in the GUI. It is the simplest path and does not require a separate backend.

Legal disclaimer

Use SoulFire only on servers that you own or have permission to test. Make sure that your hosting provider permits automated bot testing. You are responsible for unauthorized use of SoulFire.

Recommended path

Read these pages in order:

Choose Your Setup
Install SoulFire on your platform
Run Your First Session in GUI Mode

Install on your machine

Choose Your Setup

Choose the local GUI, CLI, or a remote dedicated server.

Windows (.exe)

Install the desktop app on Windows.

macOS (.dmg)

Install the desktop app on macOS.

Linux (.flatpak)

Install the desktop app on Linux with Flatpak.

Advanced paths

Use these only if you already know you need them.

Run Your First Session

Create an instance, configure a target server, and start bots from the GUI.

Deploy a Dedicated Server

Install SoulFire on a remote Linux server with the Docker setup script.

Use CLI Mode

Run SoulFire from a terminal for automation or a system without a desktop.