Troubleshooting
Diagnose common SoulFire problems by symptom instead of guessing.
Change one setting at a time. If you change several settings together, you cannot tell which change fixed the problem.
Use this section when SoulFire does not work as expected. Start with the symptom that is closest to what you see on screen or in the logs.
Before you change anything
Collect the basics first:
- the exact SoulFire version
- whether you are using GUI, CLI, or a dedicated server
- whether the problem is local or remote
- the exact error text
- the smallest setup that still reproduces the issue
- whether the problem disappears when you remove proxies or automation
This information helps other people reproduce the problem.
Pick the closest symptom
Cannot Connect Or Times Out
Use this when the GUI, CLI, or bots cannot stay connected.
Accounts And Authentication
Use this when account import, Microsoft auth, or login-related setup fails.
Proxies
Use this when proxy imports, checks, or connect attempts fail.
Scripts And Automation
Use this when visual scripts or an SDK worker behaves incorrectly.
Dedicated Server And Docker
Use this when the remote server, Docker stack, Cloudflared, or Traefik setup is the failing layer.
Troubleshoot the narrowest layer first
SoulFire problems usually occur in one of these layers:
- the client cannot reach the SoulFire server
- the SoulFire server is reachable, but the bots cannot join or stay connected to the target server
- the bots can join, but accounts, proxies, scripts, or automation change the behavior
If you can make the problem disappear by turning off one layer, you have found the right page to start from.
Related pages
How is this page?
Last updated on