Troubleshooting Installation Issues

This page helps you troubleshoot most of the common issues that you may face while self-hosting Sentient.

If Sentient is not setup properly, users might experience several issues, such as:

This guide will help you troubleshoot these common problems and get Sentient running smoothly.

To ensure Ollama is correctly installed and the right model is downloaded, follow these steps:

Open Windows Terminal and run the following command:
```
ollama run llama3.2:3b
```
If the model is already downloaded, a chat interface will open in the terminal. This confirms that Ollama is working correctly.
If the model is not downloaded, Ollama will automatically pull the model from the server. Let this process complete.
Once the model is fully downloaded, exit the terminal and restart Sentient.

To check if Sentient's backend services are running correctly:

While Sentient is running, open your web browser and visit the following URLs:
If both pages load successfully, the backend is running as expected.
If either page shows errors like “refused to connect” or “unreachable”, then there might be an issue with the backend startup. In this case, contact the developers for assistance.

If troubleshooting does not resolve your issue, you can reach out for support. When contacting us, please include:

A brief description of the issue (1-2 lines are sufficient).
A screenshot of the error message or problem.
Log files from:There will be two log files—one from the Electron app and another from the FastAPI backend. These logs help us diagnose the issue.
```
C:\\Users\\<username>\\AppData\\Local\\Programs\\Sentient\\logs
```

Join the Early Adopters Group for Support

You can connect with our development team through our WhatsApp Early Adopters group:

You can also report bugs using our official form:

Last updated 3 days ago

Was this helpful?