Troubleshooting

View Categories

Troubleshooting

2 min read

Application Won’t Start #

Symptom: Double-clicking the shortcut does nothing, or a brief window appears and closes.

Steps:

  1. Check %APPDATA%\Claudius Corp\logs\app.log for errors
  2. If the lock file is stale from a crash, delete %APPDATA%\Claudius Corp\.claudius.lock
  3. Verify Java is installed (JAR edition): java -version in a command prompt
  4. Run from command line to see console output:
    cmd
    java -jar "C:\Program Files\Claudius Corp\claudius-corp-3.1.0.jar"

Read-Only Mode #

Symptom: “Read-only mode” banner. Cannot create projects or spawn agents.

Cause: Trial expired, license expired, or offline grace period exhausted.

Fix: Go to Settings → License → enter or renew license key. Requires internet connection.

Agents Won’t Spawn #

Symptom: Phase stays in “Active” but no agent starts.

Steps:

  1. Verify Claude CLI is installed: claude --version in a command prompt
  2. Check Settings → General → Claude CLI Path is correct
  3. Check %APPDATA%\Claudius Corp\logs\app.log for spawner errors

Database Locked Error #

Symptom: Error message about database being locked, or slow performance.

Cause: Another Claudius Corp instance may be running, or a previous instance crashed without releasing the WAL.

Steps:

  1. Ensure only one instance is running
  2. If running, close it cleanly (File → Exit, not Task Manager kill)
  3. If database is still locked after clean close, restart the machine

MSI SmartScreen Warning #

Symptom: Windows shows “Windows protected your PC” when running the installer.

Cause: MSI is not code-signed. This is a known limitation (see roadmap).

Fix: Click More Info → Run Anyway.

MCP Bridge Not Connecting #

Symptom: Agent starts but immediately crashes with “Cannot connect to MCP bridge”.

Cause: Port file missing or stale.

Steps:

  1. Check that Claudius Corp is fully started before the agent is spawned
  2. Verify MCP_PORT_FILE environment variable is set for the agent process
  3. Check that the port file exists at the path specified
  4. Restart Claudius Corp — the bridge re-initializes and writes a fresh port file

License Activation Fails #

Symptom: “Activation failed” or “Cannot reach license server”.

Steps:

  1. Verify internet connectivity
  2. Check if corporate firewall blocks dmsi.gr (add exception if needed)
  3. Try again after a few minutes — the license server may be temporarily unavailable
  4. Contact support at dmsi.gr if the issue persists

For developer setup, see the Developer Manual.

Leave a Reply