Operation Modes

One product, two roles

In SoulFire there is a distinction between the client and the server. This is very similar to Minecraft, where the client is the game you play and the server is the game you connect to. In SoulFire, the client is the one that controls the bots and the server is the one that runs the bot sessions.

Integrated server (local)

The GUI/CLI comes pre-installed with a SoulFire server. This means that you can run bot sessions on your machine without needing to set up a dedicated server. This pre-installed server is only accessible from the GUI/CLI and is not meant to be used for remote access from other clients. If you want to run bot sessions via a remote server, you need to set up a dedicated server.

This is the recommended mode for most first-time users.

Dedicated server (remote)

The GUI/CLI client is the SoulFire client that connects to a remote server. This is useful if you want to run bot sessions on a remote server that you want to remotely control. This is the recommended way to run SoulFire on a remote server. You can not only have multiple users on the same SoulFire dedicated server, but you can also run multiple SoulFire dedicated servers on the same machine as well as on different machines.

How GUI and CLI fit in

• The GUI is best when you want visual control, configuration screens, plugins, and scripting tools.
• The CLI is best when you want terminal automation, headless runs, or SSH workflows.
• Both can run locally with an integrated server or connect to a remote dedicated server.

Which mode should you choose?

• Choose the integrated server when you want the simplest local setup.
• Choose a dedicated server when you want a long-running backend, remote access, or multiple clients on the same backend.
• Choose the CLI when you want automation or a keyboard-only workflow.

Related pages

• Choose Your Setup for the practical decision guide
• Run Your First Session for the beginner path
• Deploy a Dedicated Server for the automated remote setup