Administration

Deployment & licensing

Cloud, on-prem or hybrid — and how updates reach you

There are three moving parts and it is worth being precise about them before anything else, because most "I cannot find the feature" reports are really "I am looking at the wrong layer".

LayerWhat it isWho runs it
ConsoleAccount, billing, deployments and connectivity for your organizationOrcaMonitor (orcamonitor.ai)
InstanceYour OrcaMonitor workspace — devices, alerts, tickets, agentsManaged by us, or by you on-prem
AgentThe service on a host that applies updates and reports healthOn the host running the instance

Managed cloud

The default. Sign up, and a workspace is provisioned for you on its own subdomain with its own database, credentials and storage. You never see the infrastructure, and there is nothing to patch.

  1. 1
    Sign in to the console

    This is the account and deployment view, not the operations console. Devices are not visible here.

  2. 2
    Wait for Ready

    The instance is provisioned and reports Ready with its subdomain once it is serving.

  3. 3
    Open the instance

    A second sign-in on the instance subdomain. This is the operations console described everywhere else in these docs.

Console → deployment status
Console → deployment status
Console → instance, region and add-ons
Console → instance, region and add-ons
Two logins is not a bug

The console and the instance are separate trust boundaries with separate accounts and sessions. Being signed into the console does not sign you into an instance, and losing access to one does not affect the other.

On-premises

Runs the full stack inside your own infrastructure. The installer provisions the application, database, cache, secret store and the container runtime, and can be driven unattended for scripted rollouts.

  • Installer handles the service stack plus the host prerequisites, and is idempotent on re-run.
  • TLS is terminated by the bundled reverse proxy; bring your own certificate or issue one through it.
  • Data stays inside your network. Outbound access is needed only for licensing and, if you enable it, AI traffic.
  • Upgrades are applied through the same flow as managed instances — the agent runs them.

Hybrid

The instance runs on-prem while the console keeps managing licensing, updates and connectivity. This is the common choice for teams who need data residency but not the operational burden of owning the update path.

Licensing

A license carries the edition, a device limit and an expiry. The instance verifies it and reports status locally, so you can see the state without reaching out to a vendor portal.

FieldMeaning
EditionWhich capability set is unlocked
Device limitHow many devices the instance will manage, shown as used/limit
ExpiryDays remaining, surfaced on the dashboard as it approaches
Unlicensed behaviour is degraded, not broken

An expired or over-limit license restricts management rather than destroying access — you keep visibility of what is already there, which is the behaviour you want mid-renewal.

Updates

Updates are pulled and applied by the instance's agent rather than by a remote shell, so the mechanism is the same whether the instance is managed or self-hosted, and it is observable in one place.

  1. 1
    An update is queued

    From the deployment view, or by the agent's own update policy.

  2. 2
    The agent updates itself first

    The agent is brought to the current version before it applies anything, so an older agent cannot fail to understand a newer release's steps.

  3. 3
    Images are pulled and space is reclaimed

    Unused images are pruned before and after the update. This exists because a full disk is a far more common update failure than a bad release.

  4. 4
    Services restart in dependency order

    The database and pooler come up before the application, and health is checked at each step rather than assumed.

Check disk space first

If an update fails with a container reported unhealthy, check free space before reading the application logs. A full disk presents as a service that will not start, which looks like a release problem and is not.

Deployments — version, health and update history
Deployments — version, health and update history

Backups

  • Database backups run on a schedule and can be taken on demand.
  • Workspace configuration can be mirrored to a git repository for reviewable history.
  • Device configuration backups are separate — those are per-device, and they are what enable a rollback during remediation.
Reference topology — console, instance and agent
Reference topology — console, instance and agent

OrcaMonitor documentation v1.0.0 · Report a problem

Explore the full platform

See every module, pricing tier, and deployment option on the OrcaMonitor overview.

Back to Overview