Troubleshooting
Fix engines, connected apps, startup, updates, channels, voice, memory, skills, routines, computers, backups and performance, and collect a bug report.
Start with the page that matches what you see. Each page lists the exact message or symptom, then what to do.
- Engines An engine isn't found, asks you to sign in, or a model fails.
- Connected apps An app won't connect, or a bot can't use it.
- Startup and ports Murage won't open or never gets ready.
- Updates An update won't download or finish.
- Channels Telegram, Slack or Discord won't pair or reply.
- Voice and calls A call won't start or can't hear you, or a bot won't speak.
- Memory A bot forgets, or remembers the wrong thing.
- Skills and Skill Guard A skill won't import, switch on, or gets flagged.
- Routines not running A routine didn't run, ran late or was missed.
- Computer use and the browser A bot can't use your screen, its browser or a computer.
- Backups Backups won't run or restore.
- Performance Slow replies and long chats.
- Collecting a bug report Export diagnostics and report a bug on GitHub.
- Update errors The exact message on the update card, and the recovery window.
- Backup and restore errors The exact message a stopped backup or restore shows.
Before you ask for help
Note down:
- your Murage version (in SettingsGeneral) and your operating system;
- a diagnostics file from SettingsGeneralExport Diagnostics… (read it first);
- the bot's engine and model;
- the exact error message;
- whether the same engine works on its own in a terminal.
In this section
- Engine troubleshootingFix engine problems in Murage: an engine isn't detected, needs a sign-in, keeps asking you to sign in, or a model won't answer.Read
- Connected appsAn app won't connect, still shows as disconnected, or a bot can't use it.Read
- Connected apps through Flux Router: errorsWhat each Flux Router message on the Connected apps page means, and the one button or setting that fixes it.Read
- Messages too large, too many pictures, uploadsA message was not sent, some pictures were left out, an attachment was refused, or a bot could not upload a file in the built-in browser. The limits, and the way round each one.Read
- Startup and portsMurage won't open, never gets ready, or reports that every port is busy. Where to find the logs and what to try next.Read
- UpdatesHow Murage updates work on Mac, Windows and Linux, and what to do when a download keeps spinning or an update gets stuck.Read
- Channels: Telegram, Slack and DiscordFix pairing that won't complete, a Chief that doesn't reply in Telegram, Slack or Discord, approvals that don't arrive and voice messages that don't come back.Read
- Voice and callsFix calls that won't start or can't hear you, bots that don't speak, missing voices, dictation that doesn't work and voice notes that never arrive.Read
- MemoryFix bots that don't remember, remember the wrong thing, keep recalling something you corrected, or say learning isn't configured.Read
- Skills and Skill GuardFix skills that won't import, won't switch on, get flagged or blocked by Skill Guard, or that a bot ignores.Read
- Routines not runningFix routines that didn't run, ran late, show as missed or failed, or ran but didn't report where you expected.Read
- Computer use and the browserFix a bot that can't see or control your screen, a built-in browser that won't open, Use my Chrome that won't connect, and Local VM, Box or VPS computers that won't start.Read
- BackupsFix backups that won't turn on, won't run, can't reach off-site storage or can't be restored, and what to do about a lost recovery key.Read
- Performance: slow bots and long chatsSpeed up slow replies, long conversations, busy channels and a sluggish app.Read
- Collecting a bug reportExport diagnostics or a single incident, what the files contain, what never to share, and how to report a bug on GitHub.Read
- Engine connection problemsWhat to do when an engine cannot reach its provider, a sign-in or key is refused, a Flux Router key is not accepted, Codex stays busy after Stop, or an engine folder is not ready.Read
- Update errorsWhat each update message means, from a signature check that timed out to an update that could not be prepared, the Updating your memory screen, and the recovery window that opens when Murage can't start.Read
- Backup and restore errorsEvery message a backup or a restore can show, what each one means, and what to do: wrong recovery key, damaged file, drive full, daily backups paused, off-site password file problems.Read