Troubleshooting
This section lists the most common issues you may encounter during IPD self-installation or upgrade, along with their causes and solutions.
When contacting HuLoop Support, always attach logs, your environment details, and a screenshot of the error message if possible.
Server Troubleshooting (Linux)
| Issue | Possible Cause | What You Can Do |
|---|---|---|
| Docker containers won’t start | Missing config file, syntax error in .env | Check /home/huloop/.env file and rerun docker-compose up -d |
| Upgrade script fails midway | File permissions or corrupted bundle | Ensure script is executable, re-download bundle, retry ./upgrade.sh |
| HTTPS access not working | Invalid SSL cert or port 443 blocked | Check cert path and format; confirm firewall allows HTTPS |
| Admin dashboard unreachable | Container not listening or DNS error | Run docker ps and curl https://localhost to test locally |
Agent Troubleshooting (Windows)
| Issue | Possible Cause | What You Can Do |
|---|---|---|
| No icon in system tray | Agent failed to start or was blocked | Check antivirus logs, reinstall agent with local admin rights |
| Tray icon is red or gray | Server unreachable or bad URL | Confirm server is online, validate entered SERVERURL during install |
| Task Scheduler tasks missing | MSI was blocked or partial install | Reinstall agent using .msi file with /quiet flag |
| Logs not being uploaded | Network restrictions or proxy issue | Verify port 443 is open and no SSL inspection is in place |
Log File Locations
| Component | Log Path |
|---|---|
| Server Logs | /home/huloop/logs/ and /var/log/ipd/ |
| Agent Logs | C:\Users\{Username}\AppData\Roaming\KypClient\logs\ |
| Event Viewer | Windows Logs → Application (Source: KypClient) |
Note: Use these logs to identify failed services, permission errors, or missing environment variables.
Common FAQs
- Can we run IPD behind a proxy?
Yes, you can pass proxy configuration during installation using the environment variable or as part of the setup script. - Can we install on RedHat 9?
RedHat 9 is not officially supported, but installation is possible using Docker. We recommend validating compatibility with your IT team before proceeding. - Is there a rollback script?
Currently, there is no official rollback script. Please take a full backup of the server and agent configuration before attempting upgrades.
