Common issues and solutions for 2501 deployments.
Common Issues
Registry Authentication Failed
Database Connection Failed
Services Not Starting
Migration Failed
Viewing Logs
Health Checks
Reset Everything
This will delete all data. Only use this for development/testing environments.
Feature Toggles Reference
Feature toggles control various system behaviors. Modify them via SQL:
Integration Toggles
| Toggle Key | Description | Default |
|---|
enableElasticSearch | Enable Elasticsearch integration | ❌ Disabled |
enableDockerSwarm | Enable Docker Swarm orchestration | ❌ Disabled |
enablePlugins | Enable plugins system | ❌ Disabled |
Security & Logging Toggles
| Toggle Key | Description | Default |
|---|
enableSecureLogs | Enable secure logging | ❌ Disabled |
enableEmbeddings | Enable embeddings for RAG | ❌ Disabled |
enableCredentialProcessing | Enable credential processing | ❌ Disabled |
enableCommandVerification | Verify commands before execution | ❌ Disabled |
enableLogLlmInputAndOutput | Log LLM input/output | ❌ Disabled |
enableLogLlmUnparsableResponse | Log unparsable LLM responses | ❌ Disabled |
Experimental Toggles
| Toggle Key | Description | Default |
|---|
enableSlowInference | Reduce parallel tasks for slow inference | ❌ Disabled |
enableOperationalRulesVerification | Enable operational rules verification | ❌ Disabled |
enableFunctionFormatVerification | Enable function format verification | ❌ Disabled |
enableFunctionsInTheLastMessage | Enable functions in last message (experimental) | ❌ Disabled |
enableExtraLLMLogging | Enable extra LLM logging (temporary) | ❌ Disabled |
Support
For issues or questions:
- Check logs and health endpoints
- Verify configuration against this guide
- Contact 2501.ai support