Troubleshooting
| Message | Cause and fix |
|---|---|
invalid reference format |
HIWISKI_VERSION holds more than the version — the whole image name, for example. |
manifest unknown |
There is no image with that version. The versions are in the GitHub releases. |
HIWISKI_… is missing |
The variable is not set in .env, or .env is not next to docker-compose.yml. |
bind: address already in use |
The port is taken by another service. Pick another in .env. |
app stays starting, the log says password authentication failed |
HIWISKI_DB_PASSWORD was changed after the first start (see Installation). |
| Restore refused: schema mismatch | The archive comes from another version. Run the version it was made with, restore, then update. |
| The browser works, the app does not connect (iOS) | Local network access was denied — Settings → Hiwiski → Local Network. |
| The browser works, the app does not connect (Android) | A .local name; use the IP address. |
If none of this helps: Support.