{
    "product": "Cenvero Stratum",
    "generated_at": "2026-11-16T13:19:22+00:00",
    "format": "cenvero-docs-v1",
    "document_count": 1,
    "documents": [
        {
            "slug": "compute/web-console",
            "title": "The Web Console",
            "category": "Compute",
            "url": "https://stratum.cenvero.com/docs/compute/web-console",
            "headings": [
                {
                    "level": 1,
                    "text": "The Web Console"
                },
                {
                    "level": 2,
                    "text": "Opening it"
                },
                {
                    "level": 2,
                    "text": "Signing in"
                },
                {
                    "level": 3,
                    "text": "Your account, and confirming it is you"
                },
                {
                    "level": 3,
                    "text": "What you see depends on what you may do"
                },
                {
                    "level": 2,
                    "text": "What it shows"
                },
                {
                    "level": 3,
                    "text": "Tasks"
                },
                {
                    "level": 3,
                    "text": "Graphs"
                },
                {
                    "level": 3,
                    "text": "The log"
                },
                {
                    "level": 3,
                    "text": "A server's settings"
                },
                {
                    "level": 3,
                    "text": "Notifications"
                },
                {
                    "level": 3,
                    "text": "Updates"
                },
                {
                    "level": 3,
                    "text": "Tags and notes"
                },
                {
                    "level": 3,
                    "text": "Your brand"
                },
                {
                    "level": 3,
                    "text": "Creating a machine"
                },
                {
                    "level": 3,
                    "text": "Every node of a cluster"
                },
                {
                    "level": 2,
                    "text": "A machine's screen and serial console"
                },
                {
                    "level": 2,
                    "text": "When the licence refuses changes"
                },
                {
                    "level": 2,
                    "text": "Security"
                },
                {
                    "level": 2,
                    "text": "A portal for your customers"
                },
                {
                    "level": 2,
                    "text": "Current limits"
                },
                {
                    "level": 2,
                    "text": "See also"
                }
            ],
            "word_count": 6707,
            "markdown": "# The Web Console\n\nEvery node whose local API is on serves a console in the browser: the\nnode's operator sees what runs on it and manages its networks, machines,\nimages, volumes and tenants — including each machine's screen and serial\nconsole, its graphs, and every task and change made on the node — and the\nserver's own settings — its interfaces, routing, firewall, services, traffic,\nbackups, certificates, system log and updates — without a command line.\n\nThe people who run your servers sign in with **their own accounts**, each\nseeing and doing what their roles allow — see\n[Accounts and Access Control](/docs/access-control).\n\nThe same page is also a **portal for your customers**: a customer who signs in\nwith their tenant key sees only their own machines, networks and public\naddresses, and can start, stop and restart their machines, open their consoles\nand reset a password — see [A portal for your customers](#a-portal-for-your-customers).\n\n> Part of [Compute](/docs/compute/overview), in early access. The console is\n> served by the node itself; it never passes through Cenvero.\n\n## Opening it\n\nThe console lives on the same address and port as the node's local API, under\n`/console/`; the node's address on its own (`https://<node>:7070/`) leads there\ntoo:\n\n```\nhttps://<node>:7070/console/\n```\n\n- The local API must be on. A node installed with the `compute` or `suite`\n  profile has it on from the start: the installer generates the node's API\n  token, keeps it root-only in `/etc/cenvero-str/api-token`, and ends by\n  printing the console's address. Otherwise the API is off until a token is\n  set — see [API Reference](/docs/api) (`cenvero-str-ctl api-token generate`).\n  The console is on whenever the API is; there is no separate switch.\n- The page uses the node's own certificate. If the node's certificate is not\n  one your browser trusts, the browser warns first; check that the address is\n  the node's before you continue.\n- If you restricted the API to certain addresses (`api_allowed_ips`), the\n  console is restricted to them too. In a cluster, each member's own list\n  applies to your address, whichever member you signed in to (see\n  [Every node of a cluster](#every-node-of-a-cluster)).\n\n## Signing in\n\nPeople sign in with **their own account**: a Stratum account with a password,\nor through your organisation's identity provider. Scripts and the first\nsign-in can use a key. Customers sign in with their tenant key (see\n[A portal for your customers](#a-portal-for-your-customers)). Accounts, roles\nand identity providers are explained in\n[Accounts and Access Control](/docs/access-control).\n\n**The first time**, there are no accounts yet. Make the first administrator on\nthe node, as root (the password is asked for at a prompt):\n\n```bash\nsudo cenvero-str-ctl user add alice@local --role Administrator --password-stdin\n```\n\nOr sign in with the node's **API token** (on a node installed with the\n`compute` or `suite` profile, `sudo cat /etc/cenvero-str/api-token`): a banner\nsays you signed in with the node's own token, and **Accounts** opens\n**Datacenter › Permissions**, where **Add account** and **Add permission** make\nthe first administrator. Use personal accounts from then on.\n\n**With a password.** Choose the sign-in method if there is more than one,\nenter your user name and password, then the 6-digit code your authenticator app\nshows (**Use a recovery code instead** if you do not have it). An account that\nmust use a second factor but has none yet is first asked to\n**Set up a second factor**: scan the code with an authenticator app, enter the\ncode it shows, and store the recovery codes shown once — the console opens\nwhen that is done.\nEvery failure gives the same answer, whatever was wrong.\n\n**Through your identity provider.** Press **Sign in with** your provider's name;\nit signs you in and sends you back. A link to the console from your provider's\nown portal must open `https://<node>:7070/console/` — a sign-in started by a\nlink on another site is refused (see\n[Signing in through your identity provider](/docs/access-control#signing-in-through-your-identity-provider)).\n\n**With a key.** **Sign in with an API key** takes an API token, an operator API\nkey, the node's API token, or a tenant key. The key is sent once, in the\nsign-in request, over the node's encrypted connection; the browser never stores\nit, and the node keeps it in memory for the session only. A session signed in\nwith an API token or operator key cannot make the changes that need a password\nconfirmed.\n\n- The session is held in a cookie the page's scripts cannot read. It ends after\n  **30 minutes without activity** (the page warns you two minutes before), after\n  **12 hours** in all, when you sign out, and when the agent restarts. Typing\n  or using the mouse in a machine's console counts as activity; a page left\n  open on its own does not.\n- **Taking access away ends sessions at once.** Disabling or deleting an\n  account, its expiry, disabling its sign-in method, revoking the token or key\n  it signed in with, or changing the node's API token ends every session that\n  depends on it, and closes the machine consoles opened with it.\n- A tenant key signs in to that tenant's portal, never to the operator\n  console.\n- Up to 64 operator sessions can be open at once, and at most eight per\n  account: signing in again when they are all in use closes the one used least\n  recently, the account's own first. Customers' sessions are counted apart — at\n  most eight per customer account, where a ninth sign-in closes that account's\n  least recently used session — so a customer signing in again and again never\n  signs you out.\n- Sign-in attempts are limited per address (a burst of 5, then 10 a minute).\n  Five wrong keys lock that address out of the API — console included — for\n  five minutes. A user name that fails five times waits a minute before its\n  next attempt, doubling up to 15 minutes.\n\n### Your account, and confirming it is you\n\nThe menu under your name has **Your account** and **Sign out**. Your account\nhas three tabs:\n\n- **Profile** — your name and email, the roles you hold and where, and\n  **Change password** (for a Stratum account; an identity provider's accounts\n  change it there).\n- **API tokens** — make tokens for your scripts, give each\n  **its own permissions**, and revoke them. A token's secret is shown once.\n- **Second factor** — set up, replace or remove your authenticator app, and\n  make **New recovery codes**.\n\nA change that gives someone more power, or weakens a sign-in — a password, a\nsecond factor, giving Administrator, a token with everything your account\nholds, a sign-in method — first shows **Confirm it is you**: your password, and\nyour authenticator's code if you have one, or a new sign-in at your identity\nprovider. It then counts for five minutes. See\n[Confirming your password](/docs/access-control#confirming-your-password).\n\n### What you see depends on what you may do\n\nThe tree and every list hold only what your account may see; with nothing to\nshow, a page says that nothing here is visible to your account. A button for\nsomething you may not do is disabled, and says which privilege it needs. The\nnode still decides: a change it refuses shows its own answer.\n\n**Datacenter › Permissions** (for accounts that may see them) has **Accounts**,\n**Groups**, **Roles**, **Permissions**, **API tokens**, **Sign-in methods**\n(with **Add identity provider** and **Check**) and **Second factors** (who has\none, who must set one up, and **Reset**). A machine, a network and a tenant each\nhave a **Permissions** tab showing the permissions on that object, where you can\nadd one in place.\n\n## What it shows\n\nThe console is laid out like a datacenter manager: a bar along the top, a tree\nof everything on the left, the page of what you selected in the middle, and\nthe node's tasks along the bottom.\n\n- **The top bar.** Search (press **Ctrl K** or **/** from anywhere; `tag:web`\n  finds the objects tagged `web`), the tasks running now, the alerts firing on\n  every node (they open **Datacenter › Notifications**), the licence's state, and\n  the menu under your name.\n- **The tree.** *Datacenter* → the node → its **Machines**, **Networks**,\n  **Storage**, **Images** and **Tenants**, each machine with its state as a\n  shape and, when it is not the usual one, a word (*stopped*, *suspended*,\n  *degraded*). Switch to the **Tenants** view to see each tenant's machines,\n  networks and volumes together, and the operator's own apart, or to the\n  **Tags** view to see each tag with the objects that carry it. Type in the\n  filter box to find something by name, id, address or tenant. On a phone the\n  tree opens from the menu button.\n- **Pages with tabs.** Every object has its own address, so a reload — or a\n  link you send someone — opens the same page and tab.\n\n| Page | Tabs | What you can do |\n|---|---|---|\n| **Datacenter** | Summary (nodes, totals, what needs attention — with the button that fixes it —, running tasks) · Cluster · Migrations (on a cluster member: the recent moves) · Tasks · Log · Search · Permissions · Notifications · Options · Updates | Start a machine that should be running; form, join or manage a [cluster](#every-node-of-a-cluster); manage accounts and permissions; alerts and the mail server ([Notifications](#notifications)); your brand ([Options](#your-brand)); the rolling update ([Updates](#updates)) |\n| **Node** | Summary (graphs of CPU, memory, disk space and network; version, licence, modules, services, self-healing checks, capacity, alerts, the software it runs, its tags and notes) · Machines · Networks · Storage (its Media view is the disc library) · Images · Tenants · Maintenance (on a cluster member) · Tasks · Interfaces · Routing · Firewall · Services · Traffic · Backups · Certificates · System log · Updates | Create a machine (the wizard, below); change the server's settings ([A server's settings](#a-servers-settings)) |\n| **Machine** | Summary (its state explained, graphs of CPU, memory, disk activity and network, guest agent, open consoles) · Hardware (size, network cards, volumes, CD-ROM drives and the boot order) · Snapshots (the boot disk's, and its disks) · Backups (the boot disk's, and its schedule) · Options (name, protection, boot order, start at boot) · Console · Cloud-init · Migrations (on a cluster member) · Tasks · Log · Permissions | Start, stop, restart, force stop; move the machine to another member (its **Migrate** button), stopped and copied, or while it runs with **Move while running**; change size; add, reconnect or remove a network card; insert, change or eject a disc; take a snapshot; back up now; restore a backup; set the boot disk's backup schedule; change options and first-boot settings; delete ([Snapshots, backups and schedules](/docs/compute/backups)) |\n| **Network** | Summary · Addresses (which are in use, and by what — a machine, or a container) · Machines · the containers attached to it · Permissions | Turn the host gateway (masquerade, DHCP) on or off; delete |\n| **Volume** | Summary (size, what it is attached to, protection) · Snapshots · Backups (the backup schedule above the list) · Tasks | Attach, detach, back up now, snapshot, grow, set the backup schedule and how many restore points to keep, revert to a snapshot, restore a backup, delete. A boot disk cannot be detached or deleted: it stays with its machine |\n| **Tenant** | Summary (usage against quotas) · Machines · Networks · Volumes · Permissions | Set quotas; suspend and resume; delete |\n| **Task** | What it does and to what, who started it, how far it has got, when it started and ended, and its log, which follows the task while it runs | Cancel, where the operation can stop safely |\n\nDeleting anything asks you to confirm, and deleting a machine, network, volume\nor tenant asks you to type its name.\n\n**Changes appear as they happen.** A machine that stops, a task's progress, a\nvolume that is attached: the tree, the task panel and the page you are on\nfollow the node as it changes, without a reload. If that live connection is\ninterrupted the console reconnects on its own and catches up on what it\nmissed; until it is back, pages refresh every 15 seconds. (The customer\nportal refreshes every 15 seconds.)\n\n### Tasks\n\nStarting a machine, downloading an image, backing up a volume and every other\nlonger operation is a **task**. The panel along the bottom lists the latest\ntasks with their progress — for downloads and backups, the bytes done of the\ntotal — and opens at once when you start one. Open a task to read its log as\nit is written, and to cancel it where the operation can stop safely. On a\nphone, the tasks are a page of their own.\n\n### Graphs\n\nA node's graphs cover the last hour and a machine's the last 90 minutes as it happens (**Live**),\nor an hour, a day, a week, a month or a year. **Average** shows each point as\nthe average of its time step and **Peak** as its highest value. Point at a\ngraph, or focus it and use the arrow keys, to read the figures at a moment;\nevery graph can also show its figures as a table. Times are in UTC. A break in\na line is a time when nothing was recorded — the machine was stopped, or the\nagent was not running.\n\n### The log\n\nThe Datacenter's **Log** tab lists every change made to the node (and every\nattempt that was refused), every console sign-in and sign-out, and each task's\nstart and end: when, who, what, on which object, from which address, and how\nit ended. Filter by time, person, action, object or outcome; **Download**\nsaves every record the filters select, one per line; **Verify the log** checks\nthat no record was changed or removed since it was written, and says so in a\nsentence. A machine's own **Log** tab shows the records about it.\n\n### A server's settings\n\nA node's settings tabs show what the server holds and offer each control the\nserver carries out as offered; what it does not, a form never offers. Every form\nhas **Show as API call**, and the ones a command can make show the\n`cenvero-str-ctl` command too.\n\n- **Interfaces** — the cards, their addresses, bridges, bonds and MAC bindings.\n  Addresses can be added to and removed from the server's bridges, cards and\n  bonds, except those on the way the server is reached. An address added here is\n  kept across restarts, and only such addresses are offered for removal. Bonds can\n  be created with a mode and an MTU from 68 to 9216; a member that cannot be put\n  back after a restart is listed as held, with the reason.\n- **Routing** — routes, policy rules, port forwards, masquerade, floating\n  addresses, the gateway pair and, as its second view, **BGP**. A route can be\n  given a metric and a table; a default route goes in a table other than the main\n  one. The port-forward form shows the address every forward answers on, and is\n  unavailable until a masquerade rule gives the server one. Each masquerade rule\n  shows the address its range leaves as. Taking or releasing a gateway pair's\n  shared address by hand is offered only where a partner is configured and no\n  heartbeat runs.\n- **BGP** — a neighbour's TCP MD5 key is typed once and never shown again; the\n  page shows only whether the neighbour has one. The keepalive is at most a third\n  of the hold time; the page refuses a longer one before it is sent. Removing a\n  neighbour removes its import and export policies with it.\n- **Firewall** — the rules, the default action, schedules, the connection limit,\n  the connection table and the addresses the server blocks on its own, each with\n  **Unblock**.\n- **Services** — DHCP, DNS and, as its third view, **Load balancers**. A\n  backend's health can be set up or down by hand; a configured health check can\n  change it back, so to keep a backend out whatever its checks find, take it out\n  of rotation. A web (layer-7) frontend made here takes a certificate you paste:\n  the server's own certificate is put on one only on the server's command line. A\n  frontend that uses the server's own certificate, and the pools it routes to,\n  are shown without their changes, saying why; such a frontend can still be\n  deleted here.\n- **Traffic** — bandwidth limits, pools, monthly quotas, flows and accounting. A\n  bandwidth limit's burst may be left empty: it is then one second of the rate. A\n  pool member can have a rate of its own, up to what the pool has left for its\n  members. A monthly quota either alerts (notify) or, with throttle and **Hold the\n  address to almost nothing** on, holds the address to almost nothing until the\n  month resets or the quota is raised. A quota saved earlier whose words\n  contradict what it does says so, and its edit form opens with the server's\n  explanation.\n- **Networks** shows, below the managed networks, the overlay networks, VLANs,\n  VRF, Geneve tunnels, NAT64, routed addresses and address pools. Each overlay\n  network shows its device and whether it is up, and why when it is not built. A\n  VLAN can be denied by its id, from 1 to 4094, and the entry cleared again. VRFs\n  are created and deleted and their interfaces attached and released, Geneve\n  tunnels created and deleted, and NAT64's setting — on or off, prefix and pool —\n  changed in one step.\n- **Backups** — the server's backups and their schedules (in UTC).\n- **Certificates** — the server's certificate, its names, a new request and a\n  pull (see [TLS/SSL & License Operations](/docs/tls-and-license)).\n- **System log** — the server's own log lines, newest first, with secrets,\n  credentials, paths on the host and the accounts a line's details name removed,\n  and without the audit lines, which are in the **Log**.\n- **Updates** — see [Updates](#updates).\n\nThese tabs need the right to see the server's settings (`Sys.Audit`) and, to\nchange them, `Sys.Modify` — updates `Sys.Update`; see\n[Which role reaches a server's settings](/docs/access-control#which-role-reaches-a-servers-settings).\n\n### Notifications\n\n**Datacenter › Notifications** shows the alerts firing on every server, and each\nserver's alert conditions, alert history and event webhooks, each asked of the\nserver it belongs to.\n\n- **Copy to every node** adds a condition to each other server in turn and shows\n  what each answered; the condition's actions are not copied.\n- Acknowledging or resolving an alert records it under your name, and a frozen\n  licence stops neither.\n- A webhook's signing secret is shown once, when it is added.\n- **The mail server** that alert email goes through is set here. Its password is\n  never shown again; leaving it empty keeps it for the same mail server — a new\n  server, port, encryption or authority needs it again. Changing the settings\n  asks for your password again. See [Monitoring](/docs/monitoring#where-an-alert-goes).\n\n### Updates\n\n**Datacenter › Updates** shows the rolling update's plan before it starts: every\nserver in the order it is updated, what each runs and is offered, and why it\ncannot start yet. It then shows each server's progress as it happens, from\nwhichever server you watch. A rolling update can be cancelled between servers;\nthe server being updated finishes first. If it stops at a server that runs the\nnew version but failed its checks, that server is offered its own rollback; it is\nnever rolled back on its own. See\n[Upgrades](/docs/upgrades#updating-the-members-of-a-cluster).\n\n**Node › Updates** shows what the server runs, what is offered, staged and kept to\nroll back to, and offers **Check now**, **Update** and **Roll back**. Updating and\nrolling back restart the server into the version, and no licence state stops any\nof the three.\n\nWhen the server you are signed in to restarts to finish an update, your session\nends and the sign-in page says `this server restarted to finish an update; sign in\nagain`.\n\n### Tags and notes\n\nAn object carries up to 16 tags of lower-case letters, digits, `.`, `_` and `-`,\nup to 32 characters each. They show as chips on its page and in the tree's\n**Tags** view, and search finds them with `tag:name`. Each tag can be given a\ncolour (**Datacenter › Options**), shown wherever the tag appears. Notes are plain\ntext of at most 8 KiB, shown in a notes card on the object's page; an address in a\nnote is shown as text, never as a link. If someone changed an object's tags or notes since you\nopened it, your change is refused: open it again and reapply.\n\nTags organise objects; they never grant or take away access. A customer never\nsees the provider's tags or notes in the customer portal.\n\n### Your brand\n\n**Datacenter › Options** holds your brand:\n\n- a product name; a logo and a favicon (PNG, WebP or SVG, at most 128 KB and\n  32 KB); one accent colour; support text and an https support address; a sign-in\n  notice;\n- it applies to the sign-in page and the customer portal, and to this console if\n  you choose;\n- saving asks for your password again.\n\nAn accent too light to read on the console's background is darkened, keeping its\nhue, until it reaches a contrast of 4.5 to 1; the page shows the colour it will be\nsaved as before you save. An SVG must be a plain drawing: one with scripts, event\nhandlers, links, or images or styles from elsewhere is refused. The sign-in notice\nand the support line show on the sign-in page even where your name and logo are\nnot applied — to anyone who reaches it, so never put anything private there. On a\ncluster the brand is the cluster's.\n\n### Creating a machine\n\n**Create machine** opens a wizard in eight steps: its name and owner; its source,\nwhich is a base image or an install from a disc in the disc library; its size;\nits firmware (BIOS or UEFI, secure boot and a TPM, or the Windows preset); its\ndisks and media (the two CD-ROM drives and the boot order); its network cards and\npublic address; its first boot (the hostname and SSH keys, or, for a disc install,\nnothing: the installer sets the machine up); and a summary. Sensible defaults are\nfilled in — two vCPUs, 2 GiB of memory, a disk the image's size rounded up to the\nnext 10 GiB (20 GiB for a disc install), the owner's first network — and a mistake\nis named beside the field before anything is sent. The last step says in one sentence what will be\ncreated. **Show as command** gives the `cenvero-str-ctl` command that creates\nexactly the same machine (run it on the node as root), and **Show as API call**\nthe same request for the [API](/docs/api).\n\n### Every node of a cluster\n\nOn a member of a [cluster](/docs/clustering/overview) (agent 1.0.0-rc.81 or\nlater), the console manages every member, whichever one you signed in to:\n\n- **The tree** lists every member under *Datacenter*, each with its machines,\n  networks, storage and images; tenants are shared by the members and appear\n  once. A member that stops answering is marked, within a few seconds, with\n  when it was last heard from (*last seen 12 s ago*), and its objects stay\n  listed from its last answer. A member that has not finished joining is shown\n  as *joining*, and one on a version that cannot be managed from here as\n  *update needed*, with a link to its own console.\n- **Actions** on another member's machines, networks and volumes work as on the\n  node you signed in to: the member that holds them does the work, under its own\n  licence, and checks your account or token for itself. A machine's screen and\n  serial console open through the node you signed in to.\n- **Accounts are the cluster's.** Sign in to any member with the same account;\n  a change to accounts or permissions made on one reaches every member. A\n  member that cannot reach the others shows a banner saying so, with since\n  when: access changes made elsewhere are not known there yet, and changes to\n  shared settings wait until it is back in touch.\n- **Tasks, the Log and live changes** cover every member. The Log can be\n  filtered by node, and **Verify the log** answers for each member, since each\n  keeps its own log.\n- **Datacenter › Cluster** lists the members — role, whether it votes, its\n  state (online, or when it was last seen), version, cluster address, when its\n  identity expires, and a warning when its clock is off. It offers **Make a join\n  code** (the code is shown once, with a copy button, a countdown and the\n  command to run on the new node), the codes made so far with **Revoke**, and\n  **Remove…** on each other member's row (type the node's name, then press\n  **Remove node**). Under **Advanced**: giving a member a new identity,\n  replacing the cluster's certificate authority, and **Leave the cluster…**,\n  which takes the node you signed in to out of the cluster (type the cluster's\n  name to confirm).\n- **On a member whose plan no longer includes clustering**, Datacenter ›\n  Cluster says so. It still lists the members and the join codes, with\n  **Revoke**, **Remove…** and **Leave the cluster…**. Making a join code,\n  giving a member a new identity and replacing the authority wait until the\n  plan includes clustering again.\n- **On a node that is not in a cluster**, Datacenter › Cluster offers **Form a\n  cluster** (a name and this node's address, then **Form the cluster**) and\n  **Join a cluster**: paste a join code, check the address offered for this\n  node, and press **Next**. The node asks the cluster what joining would mean,\n  without using up the code, and the summary names the cluster and its size,\n  the address, the tenants that will be shared, and any conflicts that stop the\n  join. Nothing changes until you press **Join the cluster**.\n- **Creating a machine** asks where: it offers the members that can run\n  machines, have Compute in their licence and are not frozen. **Show as\n  command** says which node to run it on, and **Show as API call** addresses\n  that node (`/api/v1/nodes/<node id>/…`).\n- **A member that is not answering** keeps its pages, showing what it last\n  reported; changes to it are held back, with when it was last heard from,\n  until it is back. Everything else keeps working.\n- **A member that does not accept your address.** Each member applies its own\n  `api_allowed_ips` to your browser's address, also when you signed in to\n  another member. If a member's list does not include it, every action and\n  console on that member is refused with **403**\n  `forbidden: source address not allowed`, and Tasks and the Log name it among\n  the members that did not answer. The tree leaves its machines and networks out\n  for your browser, and the member's node is marked not manageable from there,\n  with the reason `node <name> does not accept requests from this address`.\n\n## A machine's screen and serial console\n\nA running machine's **Console** tab opens its consoles in the browser:\n\n- **Display** — the machine's screen, keyboard and mouse. Buttons send\n  Ctrl+Alt+Del, switch between fitting the window and actual size, and go full\n  screen. Up to four people can watch at once.\n- **Serial console** — the machine's first serial port, in a terminal. One\n  session per machine; if another session has it, **Take over** closes that one\n  and connects you.\n\nThe console opens these exactly as described in [Consoles](/docs/compute/consoles):\nwith a single-use ticket, from the node's own address. The same limits apply —\na session closes after 30 minutes without input, and when the machine stops.\nA machine's console never outlives your sign-in: it closes at once when you\nsign out, and when your session ends or the key you signed in with is revoked.\n\nLinks in the serial console's output are shown as text only: the console never\nopens them, so nothing a machine prints can open a window or leave the page.\n\n## When the licence refuses changes\n\nThe console shows what the licence allows, with the node's own reason:\n\n- **A frozen licence** (or none installed): a banner says the console is\n  read-only. Everything keeps running, and you can still look at everything and\n  open consoles; every change is refused until the licence is renewed, except\n  updates and rollbacks, certificate requests, lifting an automatic block,\n  acknowledging and resolving an alert, and sending the mail server's test\n  message. In a cluster, removing a member, leaving and revoking a join code\n  still work, so a node can always be taken out.\n- **A module not in the plan**: its pages still show what exists, but the\n  buttons that would change it are disabled, with the reason — for example,\n  that Storage is not included in the plan.\n- **A module that is not available on the node** (Compute on a server where the\n  virtualization service is not installed, say): the page says why, in the\n  node's words.\n\nThe console enforces nothing itself: every action goes to the node's API as\nyou, and the API applies the same checks it applies to any other client.\nA button the console shows as enabled can still be refused, and the console\nthen shows the node's answer.\n\n## Security\n\n- Every change the page makes carries a per-session token and must come from\n  the console's own page; a page on another site cannot act through your\n  session.\n- The console's pages load nothing from anywhere else and cannot be framed by\n  another site.\n- Sign-ins, refused sign-ins, sign-outs and sessions that end are recorded in\n  the node's audit log (see [Monitoring](/docs/monitoring)), and every change\n  made through the console is recorded with the session it came through. They\n  are also written to the node's log as audit entries (`audit=true`) and\n  published as the events\n  `console.signed_in`, `console.sign_in_refused`, `console.signed_out`,\n  `console.session_ended`, `console.reauthenticated` and\n  `console.reauth_refused`, so the [event stream](/docs/api) and webhooks carry\n  them. They name the account or the key that was used, never a password, code\n  or key. A refused sign-in is recorded without the user name typed, in case a\n  password was typed there.\n\n## A portal for your customers\n\nIf you host machines for customers, each customer can have this console, confined to their own tenant. You create a **tenant** for the customer and give it their machines. The customer then signs in with an **account** of their own, which you make for them (see [Customer portal accounts](/docs/tenants#customer-portal-accounts)). A customer who uses the API can have a [tenant key](/docs/tenants#scoped-api-keys) instead, and the portal accepts that too.\n\n**1. Make the customer's account.** Make it in the console or over the API. Its temporary password is shown to you once, so send it to the customer over a channel you trust. The customer must choose a new password at their first sign-in.\n\n**2. Send the customer the address.** Give them the portal name, reached through your own front (see [The portal name](/docs/tenants#the-portal-name) and [Putting the portal behind your own address](/docs/tenants#putting-the-portal-behind-your-own-address)). Without a front, the address is this node's console, `https://<node>:7070/console/`. The browser then shows the node's own certificate, which it does not trust until the account root is trusted (see [Opening it](#opening-it)). In a cluster, use any member's address.\n\n**Signing in.** The customer opens the address and signs in with their login, which is their email address, and their password. At a portal name, the sign-in page offers only the customer portal.\n\n- A wrong login or password answers `that user name and password were not accepted`.\n- The second step asks for a code from the authenticator app, or for one recovery code. A wrong code answers `that code was not accepted; enter a code from your authenticator app, or one recovery code`.\n- An account that cannot sign in answers `this account can no longer sign in; contact your provider`. For a closed tenant, a correct password answers `this account is closed`.\n\n**The first sign-in.** The password the customer was given was set by their provider, so it must be replaced, and the portal says so: `your password was set by your provider; choose a new password to continue`. The new password must be at least 12 characters, not a common one, and different from the current one. What comes next depends on the account:\n\n- If it already has an authenticator app, the customer enters a code from it, and then chooses the new password.\n- If it has none, the customer chooses the new password, and then sets up an authenticator app: `set up your authenticator app to continue; your provider needs a second factor on this account`.\n\nTo set up the app, scan the QR code the portal shows, or enter the key it shows, and then enter the code the app shows. The portal then gives the customer ten recovery codes. Each works once, in place of a code from the app, and they are shown once, so the customer must save them then.\n\n**The account page.** The **Your account** page shows the customer's login, display name and tenant, whether an authenticator app is set up, how many recovery codes are left, and whether the password must change. From it the customer can:\n\n- **Change the password.** Enter the current password, and a code from the authenticator app (or one recovery code) if there is an app, then the new password. A new password that is the same as the current one is refused with `choose a password you have not used before`. The customer's other sessions end, and this one carries on.\n- **Set up a new authenticator app.** Enter the current password and a current code, from the app or one recovery code, then a code from the new app. The old app stops working at once, the other sessions end, and new recovery codes are given, shown once.\n- **Make new recovery codes.** Enter the current password and a code from the app. The old codes stop working; the new ones are shown once, and the sessions carry on.\n\nA wrong current password or code is refused with `the current password or code was not accepted`. Each wrong one counts toward the same wait a sign-in meets: after five wrong tries the account waits, a minute at first and longer after each further wrong try, before the next check. A right one resets nothing.\n\n**Sessions.** A customer's session has the same limits as every console session: it closes after 30 minutes without activity and after 12 hours in all. An account can be signed in from four browsers at once, and a fifth closes the one used least recently. A change of password or authenticator app ends the account's other sessions.\n\n**Usage.** The **Usage** page shows the network traffic the customer's machines carried, as download and upload, with totals and this note: `the usage figures are the network traffic each machine's interfaces carried, as the server counted it; they are not a bill`. What the figures count, and their limits, are on [Usage figures](/docs/tenants#usage-figures). Each machine's own graphs are on its page.\n\n**Or a tenant key.** A key suits a customer who uses the API:\n\n```bash\nsudo cenvero-str-ctl tenant key-generate <tenant-id> --name \"acme portal\" --ttl 2160h\n```\n\nThe key is printed once. Send it to the customer over a channel you trust, and give it an expiry (`--ttl`) so it lapses on its own if it is forgotten. A key can also be minted over the API (`POST /api/v1/tenant/{id}/keys`, see [Tenants](/docs/tenants)). Revoke it with `sudo cenvero-str-ctl tenant key-revoke <key-id>`: every session signed in with it ends at its next request, and the machine consoles opened with it close within a few seconds. In a cluster where every member runs this release, the key works on every member, and revoking it on any member revokes it everywhere.\n\n**What the customer sees and can do.** The portal wears the same layout, with\na tree of the customer's own machines and networks:\n\n| Page | What they see | What they can do |\n|---|---|---|\n| **Overview** (the tenant's name at the top of the tree) | Their account's state (active or suspended), their limits and usage (machines, bandwidth, volumes), and their machines | — |\n| **Machines** | Their own machines: state, size, addresses, network cards, open consoles, guest tools, and graphs of CPU, memory, disk activity and network | Start, stop, restart, force stop; open the display and serial console; reset a user's password through the guest tools |\n| **Networks** | Their own private networks and which of their machines use them | — |\n| **Public addresses** | The public addresses their machines hold | — |\n| **Tasks** | What was done to their machines and volumes, by them or by you, and how it ended | — |\n| **Usage** | The network traffic their machines carried, as download and upload, with totals ([Usage figures](/docs/tenants#usage-figures)) | — |\n| **Your account** | Their login, whether an authenticator app is set up, and whether their password must change | Change their password; set up an authenticator app; make new recovery codes |\n| **Activity** | What was done with their keys and accounts: portal sign-ins and actions on their machines | — |\n\n**In a cluster.** Once every member runs this release, the portal shows the\ncustomer their machines, networks, addresses, tasks and activity on **every**\nmember, whichever member they signed in to, and acts on each machine where it\nruns — consoles included, through the member they signed in to. The customer\nnever sees which server is which. If the server that holds one of their\nmachines is not answering, they are told\n`this machine's server is not answering right now; your machine keeps running. Try again shortly.`;\neverything else keeps working. Their limits and usage on the **Overview** are\nthose of the member they signed in to.\n\n**What stays with you.** Creating and deleting machines, networks and volumes,\nchanging a machine's size or interfaces, and changing the account's limits,\nbandwidth or state are not in the portal, and the node refuses them to a\ntenant key whatever it sends. A customer never sees another customer's\nmachines, networks or addresses — asking for one by its id answers exactly as\nif it did not exist — nor your own machines, the node's licence or anything\nelse on the node.\n\n**When you suspend the account.** Suspending a tenant stops its machines. The\ncustomer can still sign in and look at everything, with a banner saying the\naccount is suspended, but starting, stopping or restarting a machine, opening a\nconsole and resetting a password are refused until you resume the account. A\nconsole ticket issued before the suspension is refused when it is used, and a\nconsole the customer already has open closes within a few seconds.\n\n**What the customer is told when something fails.** The portal answers in\nplain, fixed sentences — that the machine cannot be started right now, that its\nguest tools did not answer, and so on — never with the server's own error\ntext. When a machine itself refuses a new password (an unknown user, say), the\ncustomer is shown the machine's own reason.\n\n**When the node's licence refuses changes.** A frozen licence refuses the\ncustomer's power actions and password resets just as it refuses yours; the\ncustomer is told that changes are paused on the server and that their machines\nkeep running. Looking and opening consoles still work.\n\n**What the customer's actions leave behind.** Power actions, password resets,\nconsole sessions and portal sign-ins are recorded in the node's audit log naming\nthe tenant key's id or the account's id, which is never its login (`cenvero-str-ctl audit list --tenant <id>`), like yours; the\ncustomer can read its own records in the portal's API\n(`GET /api/v1/tenant/{id}/audit`). Consoles the customer opens appear on\nthe machine's page in your console.\n\nThe portal shows what the customer's key allows; the node's API decides. A\ncustomer holding the key can make the same calls with any HTTP client — the\n[API Reference](/docs/api) lists what a tenant key may call.\n\n## Current limits\n\n- Without a cluster, one node per console: open each node's own address. Join\n  the nodes into a [cluster](/docs/clustering/overview) to manage them all from\n  any one of them.\n- A browser session belongs to the member it was opened on: signing in to one\n  member does not sign you in to another, though the same account works on each.\n- Customer accounts work across a cluster once every member runs this release. Until then a customer signs in with a tenant key. A customer's machine and volume limits count across the cluster once every member runs a version that supports it; its address and rule limits are still set and shown per node.\n- Customers cannot yet create their own machines — provisioning goes through\n  you (or your billing system over the API).\n- Sessions live in the agent's memory: restarting or updating the agent signs\n  everyone out.\n\n## See also\n\n- [Consoles](/docs/compute/consoles)\n- [Virtual machines](/docs/compute/virtual-machines)\n- [Tenants](/docs/tenants)\n"
        }
    ]
}