Troubleshooting¶
Start with a structured environment check:
Apply low-risk local setup fixes:
Collect diagnostics after service failures:
Use a reduced bundle when the output may be shared outside a private project team:
Docker Is Not Running¶
Likely cause: Docker Desktop or the Docker daemon is stopped, or the current user cannot access the Docker socket.
Check:
Recovery:
Start Docker, then rerun:
If Docker is running but access fails, fix local Docker permissions outside this
repo and rerun mbse-lab doctor.
Port Conflict¶
Likely cause: another local process is already using one of the Flexo or SysON host ports.
Check:
Recovery:
Edit the relevant ignored env file:
Then restart the affected stack:
Flexo Org Is Missing¶
Symptom:
Likely cause: the Flexo SysML v2 org has not been initialized in the local Fuseki graph.
Recovery:
Then retry the Flexo create or bridge command.
SysON Password Drift¶
Likely cause: deploy/syson/.env was regenerated or edited after Postgres data
already existed under deploy/syson/data/postgres/.
Check:
Recovery:
Restore the password that matches the persisted database, or intentionally reset the local SysON database by stopping services and removing the ignored Postgres data directory. Only remove the data directory when you accept losing local SysON projects.
After the password or data reset is fixed:
SysON Starts Slowly¶
Likely cause: first startup, database migration, or a busy local Docker engine.
Check:
Recovery:
Increase the wait timeout:
If the app keeps restarting, collect diagnostics:
Import Succeeds But The Diagram Looks Empty¶
Likely cause: the bridge imports textual SysML into SysON, but diagram layout is not round-tripped. The current renderer also emits a conservative subset of SysML v2 element types.
Check the rendered text and coverage report first:
Recovery:
Open the imported package in SysON and create or adjust graphical views there. Use the render coverage report to see which Flexo element types were rendered, unsupported, or skipped. The bridge is a snapshot import path, not a live diagram sync.