Forge Connections

Terminal keeps a list of public Forge API endpoints. Open Settings and choose Add Connection.

Enter the API base URL

Use a browser-reachable URL ending in /api/v1:

https://forge.example.com/api/v1

Terminal normalizes a missing root path to /api/v1 and derives WebSocket addresses from the same base. The URL must work from both the user’s browser and the Terminal server process.

Test the connection

The connection editor calls the Forge /health endpoint. A successful health response confirms the API process is reachable; the Doctor result also checks upstream control-plane availability.

Select a server

The active server controls all Terminal loaders, browser requests, direct links, and WebSocket connections. Project IDs and resource keys are scoped to that selected Forge environment.

Terminal requires at least one configured server. Removing a connection does not delete projects or data from Forge.

Remote access

Do not register localhost unless the browser and Terminal process can both reach the intended Forge on their own localhost. For a remote Forge, configure its explicit public hostname and TLS route.

The SSH target used by aurum push is separate; see Remote Targets.