Install troubleshooting
Use this page when installation, first admin setup or first public API checks do not behave as expected.
Checklist#
- Confirm the supported package repository at repo.eldric.ai is reachable from the host.
- Confirm the installed package version matches the intended 5.0.x line.
- Confirm DNS and TLS for the public entry point before testing browser or API clients.
- Confirm the first administrator flow has completed once and is not being repeated by another user.
- Confirm the license file or evaluation mode matches the intended tier.
- Confirm the public health endpoint responds before testing higher-level workflows.
Common symptoms#
| Symptom | Likely next step |
|---|---|
| Package install fails | Check repository reachability, OS support and package signature trust. |
| Browser cannot open chat | Check hostname, TLS and public route. |
| API returns 401 | Check API key, session state and tenant scope. |
| RAG upload succeeds but no citations appear | Check indexing status and selected knowledge base. |
| macOS package warning | Use the signed package workflow documented by Eldric support. |
For unresolved install issues, contact office@eldric.ai with version, operating system, deployment shape and the redacted error message.