The app cannot reach its host
The desktop app runs its own host. If the host stops after it was ready, the app restarts it, up to three times in five minutes. If it stops while starting, the app says why, with Try Again and Show Log.- Restart it by hand with File → Restart Archetype.
- If the app says The host started again. Open Archetype again to reconnect., close and open the app.
- A host on a server: the app connects with your system’s
ssh, which must work from a terminal without a password prompt. Use Reconnect (in File, or Manage → Settings → Servers). An older server is offered Update and Reconnect. If it still cannot connect, Use This Computer opens the local host instead. - A phone: if it says Could not reach your computer, check the computer is on and the app or its host runs there. If Archetype says a port is taken, set
phones.portin the config file to another. See Devices.
Chats, schedules or triggers get no answer
These run in the background service, also with the app closed.~/.config/archetype/env, one NAME=value a line, readable only by you (chmod 600): the service refuses to start if others can read it.
A sign-in expired
An MCP server fails
"disabled": true does not run. See MCP servers.
A plugin is off or missing
- Check Manage → Plugins. Drafts and Meals are off until you turn them on.
- A plugin turned off in
~/.config/archetype/config.json("plugins": { "name": false }) stays off. - On a company’s host, an admin chooses which roles see a plugin and get its tools. If yours does not, ask an admin. See Hosting a company.
- Music works on a Mac only, and needs macOS to allow Archetype to control the app. See Music.
Notifications do not come
- Open Manage → My settings → Notification settings. Each device says whether it gets them: Off in the system’s settings, Off in this browser, Blocked by this browser or Not reachable say why not.
- Turn them on in the system’s settings for Archetype, then check again.
- Quiet hours hold notices back, and Muted sessions get none.
- A notice is not shown while its conversation is on screen in a focused window.
- A team’s mentions, replies and decisions follow that team’s own preferences.
Where the logs are
Logs leave out access tokens. Look over a log for anything private before you send it.
Report a problem
Email help@archetype.ing with:- what you did, what you expected and what happened;
- the computer and system, and
archetype --version; - the output of
archetype --doctor, and the lines of the log around the problem; - for a connected app or a plugin, its name.