Troubleshooting

The most common problems and their fixes.

A module does not show up #

Check that it started and registered (logs), that its port is not already taken, and that X-Internal-Secret matches between the core and the module.

"start-limit-hit" on restart #

sudo systemctl reset-failed kubuno && sudo systemctl restart kubuno

Build failing on SQLx #

The .sqlx cache goes stale after a query/schema change: regenerate it (cargo sqlx prepare) or build with SQLX_OFFLINE=true if the cache is up to date.

DB connection refused #

Check KV__DATABASE__*, that PostgreSQL is reachable, and the encoding of special characters in the password.