Gateway

The Gateway is Anyy's resident runtime. It owns live sessions, tools, channels, schedules, background jobs, and delivery while TUI, Dashboard, CLI, and messaging clients connect to it.

Check the Service

anyy gateway status

The result identifies the resolved Profile home, service host, socket, process state, and whether the installed service command matches the current Anyy version.

For a broader product view, also run:

anyy status

Start and Stop

anyy gateway start
anyy gateway restart
anyy gateway stop

start installs the supported user service when it is missing and waits briefly for the runtime to become reachable. restart also recovers a missing service installation before starting it.

Anyy uses the supported service manager on the host, including a launchd user service on macOS, a systemd user service on common Linux systems, and the supported procd or s6 integration where installed.

Stop interrupts resident work

Stopping the Gateway disconnects channels and pauses live schedules, background work, and all connected surfaces. Check active work before maintenance.

Select a Profile

Each resident Gateway serves one resolved Profile:

anyy --profile work gateway status
anyy --profile work gateway restart

Do not point two unmanaged Gateway processes at the same Profile. Profile ownership protects state-changing offline operations from racing a live runtime.

When to Restart

Most supported setup and Dashboard changes reload live state without a manual restart. Restart when:

• gateway status reports a command/version mismatch;
• a remediation message explicitly asks for restart;
• the service is installed but unreachable after normal reload; or
• you are completing an offline maintenance procedure.

Troubleshooting

1. Inspect the service:

   anyy gateway status

2. Run product diagnostics:

   anyy doctor

3. Restart the resolved Profile's service:

   anyy gateway restart

4. Re-run status and doctor before changing sockets or service-manager files manually.

Symptom	Likely next step
Service is not installed	anyy gateway start
Installed command is from another version	anyy gateway restart after updating Anyy
Dashboard/TUI cannot connect	Verify they resolve the same Profile and socket
Offline maintenance cannot acquire ownership	Stop the Gateway for that Profile, then retry

See Status & Doctor for the diagnostic fields.