Workspace

Dashboard

The Oblien dashboard provides a visual interface for managing workspaces, monitoring usage, and configuring your account.

Access it at oblien.com/dashboard.

Workspace list

The main dashboard page shows all your workspaces with:

  • Status indicator - Ready, Paused, Hibernated, Stopped and operation progress such as Hibernating or Resuming
  • Quick actions - Start, stop, restart, delete
  • Resource summary - CPU, memory, disk allocation
  • Image - Base image used
  • Uptime - How long the workspace has been running

Create a workspace

  1. Click Create Workspace
  2. Select an image (e.g., oblien/node:24, oblien/python:3.13)
  3. Configure resources (CPU, memory, disk)
  4. Set mode (permanent or temporary)
  5. Optionally set a startup command, environment variables, and network rules
  6. Click Create

The modal shows real-time quota validation - you'll see warnings if your resource selections exceed your plan limits.

  • Filter by status: Running, Stopped, Paused, All
  • Search by workspace name or ID
  • Sort by creation date, name, or status

Workspace detail

Click any workspace to open its detail view with multiple tabs:

Overview

  • Current status and uptime
  • Resource allocation (CPU, memory, disk)
  • Network configuration
  • Quick action buttons
  • A namespace link that opens the workspace's namespace

Audit

See who changed the workspace, when, and the outcome. Filter by action, actor, outcome or time. Audit history is available during preparation and while stopped. The Audit item in the dashboard sidebar shows history across your workspaces, including workspaces that have been deleted. See Audit history.

Terminal

A full browser-based terminal connected to the workspace via WebSocket. Features:

  • Scrollback buffer - Scroll through previous output
  • Search - Find text in terminal history (Ctrl+Shift+F)
  • Resize - Terminal adapts to your browser window
  • Reconnect - Auto-reconnects on connection loss
  • Terminal history - Set retained output and browser scrollback limits, or clear output without stopping the shell

Logs

View workspace logs in real-time:

  • Boot logs - VM startup and initialization
  • Command logs - Output from startup commands
  • Workload logs - Per-process logs for managed workloads

Logs stream via SSE (Server-Sent Events) and update in real-time.

Each workload's log viewer includes Log retention and Clear stored logs. The default is up to 20 MiB and 7 days per workload. Clearing deletes retained output while the process continues running. The browser keeps a bounded recent tail; pause disconnects the viewer, and resume loads the retained history. See workload log controls.

Metrics

Live monitoring charts showing:

  • CPU usage - Percentage over time
  • Memory usage - MB used vs allocated
  • Disk I/O - Read/write throughput
  • Network - Inbound/outbound traffic

Metrics update via SSE streaming for real-time visibility.

Files

Browse and manage the workspace filesystem:

  • Navigate directories
  • View file contents
  • Upload files (base64 encoded)
  • Check disk usage

Network

Configure networking from the UI:

  • Toggle internet access
  • Manage firewall rules (ingress/egress)
  • Expose ports for public access
  • View preview URLs

SSH

Enable or disable SSH access:

  • Toggle SSH on/off
  • Set authentication method (password or key)
  • View connection command
  • Copy SSH details to clipboard

Workloads

Manage long-running processes:

  • View active workloads
  • Start/stop individual processes
  • View per-workload logs
  • Monitor workload status

Snapshots

Use the power controls to choose how a workspace stops:

  • Pause freezes execution and keeps RAM allocated. Resume continues the same process.
  • Hibernate saves RAM and virtual-device state to disk, then releases the running process and memory. It shows Hibernating, then Hibernated. Resume restores the saved session.
  • Stop shuts down the workspace. Start performs a new boot from its persistent writable disk.

Hibernate uses the existing snapshot API. It is disabled when the runtime cannot safely save memory, including nested KVM workspaces such as the current Mac image. Hover over the disabled control for the reason. Progress persists across a dashboard refresh.

Disk archives are separate backups available through the Snapshots & Archives API.

Pages

The workspace's Pages tab lists static Pages exported from that workspace. Choose Create Page to export a build output folder with the workspace already selected. Exporting requires a running workspace; existing Pages stay available after it stops. The workspace owner manages these deployments.

All Pages

Pages in the Services sidebar lists your static Page deployments, including Pages created through the API or SDK. Cards show the namespace, source workspace, status, public URL, and creation/update dates. Open a Page for its Deployment overview, Domain & SSL, Analytics, and optional Path rules, or use Refresh to check for new deployments. See Pages.

Routes and analytics

Routes lists every registered public hostname owned by your account: workspace URLs and ports, static Pages, edge proxies, and tunnels. Filter by resource type, status or namespace, or search by hostname. Disabled routes and routes with no recorded traffic remain in the inventory.

Each hostname opens its own Analytics, with an overview, selectable time range and live request log. Root domains and www aliases are separate hostnames. The Page, workspace, proxy or tunnel link opens the resource that owns the route. Old /dashboard/analytics links redirect to this view.

Route-list traffic counters cover recorded history. In the detailed view, overview cards and the chart use the selected range; country data covers at most the last 24 hours, and recent requests are the latest captured records.

Usage

Usage separates spending from resource allocations:

  • Account credit balance shows the wallet balance and links to Add credits.
  • Credit spending shows recorded deductions over 7, 30 or 90 days, with an optional namespace filter. Expand Show spending breakdown for paginated namespace/service rows. The total includes every matching record, not just the visible page. Deductions include usage and prepaid purchases; refunds, top-ups and cash invoices are separate in the credit ledger and Payments screens.
  • Account workspace allocations shows owned workspace counts, per-workspace maximums and both running and owned resource pools. These are allocated CPU, RAM and disk, not actual utilization. Open a workspace for live metrics.
  • Account edge usage shows traffic for its actual billing period and active Page, proxy and tunnel counts. A custom-domain alias does not use another resource slot. Expand the namespace breakdown to inspect its resources.
  • Usage discounts shows the current UTC month's cap savings and prepaid coverage using the backend's billing comparison.

The spending namespace/period controls apply only to credit spending. Resource limits remain account-wide, and edge traffic and cap savings show their own periods. Namespace policies may impose lower limits; open Namespaces to inspect them. Unlimited and not-included allowances are labeled explicitly. If a read fails, its section shows a retry control instead of a zero balance or an empty inventory.

Pages, Routes and account billing views use your personal account. Shared workspace access does not grant access to the owner's account-wide Pages, route traffic or wallet data.

Settings

Plan management

View and manage your subscription from the Pricing page.

API keys

Manage your API credentials:

  • View your Client ID
  • Rotate your Client Secret
  • View API key creation date

Credits

Monitor your credit balance and purchase additional credits from the dashboard. See the Pricing page for plan allowances and credit packages.

Notifications

Configure alerting preferences:

  • Low credit balance alerts
  • Workspace status change notifications
  • Usage threshold warnings

Quota banner

When approaching plan limits, a banner appears at the top of the workspace list showing:

  • Pool usage (owned and running)
  • Number of workspaces vs limit
  • Which resource is the bottleneck
  • Link to the Pricing page to upgrade

Keyboard shortcuts

ShortcutAction
Ctrl+KQuick search / command palette
Ctrl+Shift+FSearch in terminal
Ctrl+CCopy selected terminal text
Ctrl+VPaste into terminal