New User, Docker, LLMChat, Virtual Server

[twoxfh]

Hello there! I am looking to setup a bare minimum development environment to check out the features. I successfully completed the below steps, however, my virtual server is inactive. How do I activate an inactive virtual server? I am not seeing any UI element to change its status.

1. Started two Docker images OpenAI Endpoint and IBM Context Forge with LLMChat enabled.
2. Created Docker network to connect Docker images together
3. Validated LLMChat can connect to OpenAI Endpoint
4. Created a REST service tool
5. Created a Virtual Server.

Thanks for reading!

[crivetimihai]

Hi @twoxfh, thanks for this. If you share compose/docker env + startup command and where the auth flow breaks, I can reproduce and provide a direct onboarding checklist for Docker + LLMChat + virtual server usage.

[crivetimihai]

Hi @twoxfh, sorry for the delayed answer. To activate an inactive virtual server:

Via Admin UI: Go to the Virtual Servers page, click on your server, and toggle the Enabled switch. The server detail page has an activate/deactivate form control.

Via API:

curl -X POST "http://your-server:8080/servers/{server_id}/state?activate=true" \
  -H "Authorization: Bearer $TOKEN"

Common reasons a virtual server shows as inactive:

1. It was created with enabled: false — the default is true, but some creation flows may behave differently
2. No tools are associated with the server — while the server object exists, the UI may display it as inactive when it has zero tools
3. A previous deactivation via the API or UI toggle

The enabled field (defined in db.py:4283) is the sole control for server state. The API endpoint is POST /servers/{server_id}/state?activate=true|false (defined in main.py:3899).

If the issue persists, please share your Docker Compose setup and the server detail page output and I can help troubleshoot further.