Skip to main content
The web dashboard is a browser-based control panel for managing your Comis installation. It lets you chat with agents, view sessions, manage memory, manage agent workspaces, check observability data, and configure settings — all from your browser. This page covers how to set up the dashboard. For how to use each view, see the Web Dashboard documentation.

​
How It Works

The web dashboard is a single-page application built into Comis and served by the gateway — the same HTTP server that handles API requests. There is no separate installation required. By default, the dashboard is available at: 
http://localhost:4766
Open this URL in your browser to access the dashboard. You will be prompted for a gateway token to authenticate.

​
Configuration

The gateway settings in your config.yaml control how the dashboard is served: 
# config.yaml
gateway:
  enabled: true
  host: "127.0.0.1"     # Only accessible from this machine
  port: 4766            # Dashboard and API port
  corsOrigins: []        # Same-origin only (no cross-domain access)
SettingDefaultWhat It Does
enabledtrueWhether the gateway (and dashboard) is active
host"127.0.0.1"Which network interface to listen on. 127.0.0.1 = localhost only (secure). 0.0.0.0 = all interfaces.
port4766The port number for both the dashboard and API
corsOrigins[] (empty)Allowed cross-origin domains. Empty means same-origin only.
Setting host to "0.0.0.0" exposes the dashboard to your entire network. Make sure you have a strong gateway token configured and ideally put Comis behind a reverse proxy with TLS.

​
Authentication

The dashboard requires a gateway token to access. Tokens are configured in your config.yaml: 
# config.yaml
gateway:
  tokens:
    - id: "admin"
      secret: "your-secure-token-here-minimum-32-characters"
      scopes: ["rpc", "ws", "admin"]
When you open the dashboard, enter this token to authenticate.
If you see "Gateway token auto-generated (ephemeral)" in your logs, the daemon created a temporary token because none was configured. This token is lost on restart. Set a permanent token in your config to avoid re-entering it after every restart.

​
Accessing from Other Machines

To access the dashboard from another computer on your network:
1

Update the gateway host

Change the host in your config.yaml:
gateway:
  host: "0.0.0.0"
This makes the gateway listen on all network interfaces instead of just localhost.
2

Open the dashboard

From another machine on your network, open:
http://<your-server-ip>:4766
Replace <your-server-ip> with the IP address of the machine running Comis.
3

Enter your gateway token

Authenticate with the token configured in your config.yaml.
For production use, put Comis behind a reverse proxy with TLS instead of exposing port 4766 directly. This encrypts all traffic between your browser and the server.

Web Dashboard

How to use each view in the dashboard

Reverse Proxy

TLS and custom domains with Nginx or Caddy

Daemon

The background process that serves the dashboard

Configuration

Full configuration guide including gateway settings