Skip to content

Web service dashboard

Open Web Services in the sidebar to see every service in your workspace. Each card shows the status, subdomain, CPU and memory, with a quick Start or Stop button. Click a card to open the service.

Web Services list with three service cards, two running and one stoppedWeb Services list with three service cards, two running and one stopped
The Web Services list. Click a card to open the service.

A web service has seven tabs.

The header is the same on every tab: the service name and status badge, its runsite.app URL, the service ID, and the Redeploy, Restart and Stop buttons.

The Overview tab shows the basics of your service (type, CPU, memory, port and traffic used this month) and the full deployment history. Each deployment row has its commit, branch, who triggered it and when. Open the build log from any row, or Rollback to a previous successful deploy with the orange button.

Overview tab with resource tiles and a list of three successful deploymentsOverview tab with resource tiles and a list of three successful deployments
Overview: resources at a glance and the deployment history.

The coloured badge next to the service name reflects its current state:

ColourStateWhat it means
YellowDEPLOYINGBuilding the image or rolling out a new container.
GreenRUNNINGLive and serving traffic.
BlueSTARTINGComing up after Start or a restart.
BlueRESTARTINGContainer restart in progress.
GreySTOPPINGStop in progress.
GreySTOPPEDManually stopped. Compute is released; env vars and the disk are kept.
GreySLEEPINGIdled out. The next request wakes it.
RedFAILEDBuild or runtime failure. The previous version keeps serving.

For the full semantics and transitions, see Runtime → Deploy states.

Current CPU, memory, instance count and traffic, each against its limit, followed by charts of CPU and memory usage and Request Metrics (request rate and error rate). Pick a window: 10 minutes, 30 minutes, 1 hour or 2 hours. Charts auto-refresh while the service is running.

Metrics tab with CPU, memory, instances and traffic tiles above CPU and memory chartsMetrics tab with CPU, memory, instances and traffic tiles above CPU and memory charts
Metrics: usage against plan limits.

Whatever your app writes to stdout and stderr.

Live tail streams new lines as they arrive; Pause and Resume hold the stream still while you read something. You can also look back over a fixed window (last hour, 4 hours, 24 hours, 2 days or 7 days), search, filter by level (error, warn, info, debug), copy the lines or Download the current view as a file.

Logs tab with a time window selector, search, level filters and nine info linesLogs tab with a time window selector, search, level filters and nine info lines
Logs: search and filter by level.

A terminal inside your running container. Use it to run a migration by hand, poke at a config file, or check what actually got deployed. Press Connect to open a session. Available while the service is running.

Shell tab connected to the container, showing the output of ls in /appShell tab connected to the container, showing the output of ls in /app
Shell: a terminal inside the running container.

Variables and secrets for the service.

Add, edit and delete variables inline. Values are masked by default; click the eye to reveal one. You can bulk import from a .env file or export the current set back to .env, and there is a built-in generator for tokens and keys.

When saving, you pick how aggressively the change applies:

ModeEffect
Save onlyStored only. Applied on the next restart or deploy.
Save and restartRestart the container now with the new values.
Save, rebuild, and deployBuild a new image and deploy. Use when the change affects build-time.

Without a disk, container storage is ephemeral and resets on every restart. Turn on Add Persistent Disk (€0.25/GB/month) and press Save Disk Settings to attach one. Once attached, the tab shows disk size, mount path and current usage. The disk survives restarts and redeploys, so use it for a SQLite file, user uploads or a local cache.

Disk tab with no disk attached and the Add Persistent Disk toggleDisk tab with no disk attached and the Add Persistent Disk toggle
Disk: attach persistent storage.

All configuration for the service, one card per topic. Changes collect in the bar at the bottom until you press Save all settings.

Settings tab with General, Domain, Custom domains, Plan, Scaling, Deploy hook and repository cardsSettings tab with General, Domain, Custom domains, Plan, Scaling, Deploy hook and repository cards
Settings: every card, with the save bar at the bottom.

General holds the name and description. Domain holds your subdomain on runsite.app. Custom Domains is where you attach a domain of your own, verify its DNS and get TLS issued automatically; see Domains for the records to add.

Build & Deploy covers the branch, the build, start and pre-deploy commands, the Dockerfile path, the root directory and the Auto-deploy on push toggle. A service deployed from a public repository URL shows Public repository URL in its place. Plan shows the compute tier; Change plan briefly restarts the service to apply the new limits. Scaling sets min and max instances, described in Scaling & resources.

Deploy hook generates a URL that redeploys the service when it receives a POST request, so CI such as GitHub Actions can trigger deploys.

IP geolocation by DB-IP