Troubleshooting

Most issues can be diagnosed from Cerebion Rivet's log files. This page explains where to find them and how to interpret common errors.

Log File Locations

Cerebion Rivet writes two log files:

• app.log — all activity (INFO and above)
• error.log — errors only

Windows

C:\Users\<your-username>\AppData\Local\CerebionRivet\logs\

Or in the same folder as the installed application:

C:\Program Files\CerebionRivet\logs\

macOS

~/Library/Application Support/CerebionRivet/logs/

Linux

~/.local/share/CerebionRivet/logs/

Sending Logs to Support

When contacting support, please attach both app.log and error.log. To find them quickly:

• Windows: Press Win + R, type %LOCALAPPDATA%\CerebionRivet\logs, press Enter
• macOS: Open Finder → Go → Go to Folder → paste ~/Library/Application Support/CerebionRivet/logs
• Linux: Run xdg-open ~/.local/share/CerebionRivet/logs

Zip the logs folder and attach it to your support ticket.

Common Issues

App won't start — "License not valid"

Your license key is missing or invalid. Go to Settings → License and enter your license key. If you don't have one, start a free trial or check your purchase confirmation email.

App won't start — "License check failed"

The app couldn't reach the license server. Check your internet connection. If you're in an air-gapped environment, you need an offline license file — contact support@cerebion.com.

Binary analysis returns no results

The file may be packed or encrypted. Try switching to Deep analysis depth in the scan options. If the issue persists, check error.log for details.

Certificate scan fails with "Connection refused"

The target host may be unreachable or blocking the connection. Verify the hostname and port are correct and that your network allows outbound connections on that port.

Code analysis shows "opengrep not found"

The OpenGrep analysis engine is bundled with Cerebion Rivet. If this error appears, try reinstalling the application. Check error.log for the exact path it's looking for.

AI fixes not generating

An AI provider API key is required. Go to Settings → AI Configuration and enter your OpenAI or compatible API key.

Still stuck?

Open a support ticket and attach your log files. We aim to respond within one business day.