# Dashboard > A map of the signed-in app at prized.dev/dashboard: every screen, its controls, and where each setting lives. URL: https://prized.dev/docs/dashboard The same fleet view, with live charts and processes, runs in your terminal too: `prized dashboard` ([Terminal dashboard](https://prized.dev/docs/cli#terminal-dashboard)). ## Layout [#layout] | Where | What | | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Sidebar | Boxes, Secrets, Connectors, Activity, **Settings**, and **Help** at the foot, with what is left of the [free credit](https://prized.dev/docs/billing#free-credit) while you are on it | | Help, foot of the sidebar | **Restart onboarding** walks you through the tour again (your workspace stays as it is, and teammates are not sent into it), then the Docs, Quickstart, CLI reference and Troubleshooting, each in a new tab | | Workspace name, top of the sidebar | A menu: your email, **Settings**, **Switch workspace**, **Sign out**. The **+** beside it creates a box | | Settings | **Account** (Profile, Security), then **Workspace** (General, Members, Policies, Billing, Audit log, Data and privacy) | | Top banner | Money needs attention ([When we tell you](https://prized.dev/docs/billing#when-we-tell-you)), the workspace is closing (with **Reopen**), or a signed-in machine's CLI is too old to [update itself](https://prized.dev/docs/cli#updates) | | Bottom-right card | Until a machine signs in with `prized login`: the CLI [install command](https://prized.dev/docs/quickstart#2-install-the-cli) with your sign-in link, for macOS or Linux, or Windows; **x** hides it for two weeks | ## Screens [#screens] | Screen | Route | What you can do | Details | | -------------------------- | --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------- | | Boxes | `/dashboard` | See your boxes, then your team's, with their state and vitals; copy a `prized ssh` command | [Boxes](https://prized.dev/docs/boxes) | | Boxes: Deleted | `/dashboard/deleted` | Undo a box delete; templates whose source box is gone | [Deleted](#deleted) below | | New box | `/dashboard/boxes/new` | Pick a size, name, template, region and per-box vars; create | [Create](https://prized.dev/docs/boxes#create) | | Box: Overview | `/dashboard/boxes/` | State, `prized ssh` command, **Open terminal**, machine facts, live numbers, ports and their links, activity; pause or resume, resize, move region, auto-pause, share a port, snapshot, template, delete | [Boxes](https://prized.dev/docs/boxes) | | Box: Snapshots | `/dashboard/boxes//snapshots` | Take, restore, delete and name snapshots; the automatic schedule | [Snapshots](https://prized.dev/docs/snapshots) | | Box: Settings | `/dashboard/boxes//settings` | Pause deadline, quiet hours, phone access, per-box vars, delete | [Boxes](https://prized.dev/docs/boxes) | | Box: Terminal | `/dashboard/boxes//terminal` | A shell in the box's tmux session, or herdr's once the box has it | [Sessions](https://prized.dev/docs/sessions), [herdr](https://prized.dev/docs/herdr) | | Box: Desktop | `/dashboard/boxes//desktop` | A Linux desktop or one Chrome window, streamed | [Desktop](https://prized.dev/docs/desktop) | | Box: Metrics | `/dashboard/boxes//metrics` | Live and historical cpu, memory, network, disk, ports and processes | [Telemetry retention](https://prized.dev/docs/data-retention#telemetry-retention-windows) | | Box: Files | `/dashboard/boxes//files` | Browse, edit, upload, download, rename and delete files | [Files](#files) below | | Connectors | `/dashboard/connectors` | Mount a provider credential into a box | [Connectors](https://prized.dev/docs/connectors) | | Secrets | `/dashboard/secrets` | Create, rotate, grant and delete brokered secrets; see what each was spent on | [Secrets for agents](https://prized.dev/docs/credentials#secrets-for-agents) | | Activity | `/dashboard/workspace/activity` | What the team is doing now | [Teams: Team activity](https://prized.dev/docs/teams#team-activity) | | Settings: Profile | `/dashboard/settings` | Your name and email | [Account](#account) below | | Settings: Security | `/dashboard/settings/security` | Your sign-in providers and browser sessions | [Account](#account) below | | Settings: General | `/dashboard/workspace` | Workspace name, icon, domain, cloud federation | [Workspace settings](#workspace-settings) below | | Settings: Members | `/dashboard/workspace/members` | Invite link, members and roles | [Workspaces](https://prized.dev/docs/workspaces) | | Settings: API keys | `/dashboard/workspace/api-keys` | Keys for machines and scripts: make, list, revoke | [Workspaces: API keys](https://prized.dev/docs/workspaces#api-keys) | | Settings: Policies | `/dashboard/workspace/policies` | Spend and box caps, largest size, auto-pause floor, quiet hours, audit retention | [Teams: Policies](https://prized.dev/docs/teams#policies) | | Settings: Billing | `/dashboard/billing` | Plan, balance, top-ups, overage, what each box burns, the Stripe portal | [Billing](https://prized.dev/docs/billing) | | Settings: Audit log | `/dashboard/workspace/audit` | Who did what; filter, download a CSV, set up the scheduled export | [Teams: Audit log](https://prized.dev/docs/teams#audit-log) | | Settings: Data and privacy | `/dashboard/workspace/data` | Zero data retention; close or erase the workspace | [Data retention](https://prized.dev/docs/data-retention) | ## Boxes [#boxes] One card per box, grouped **Needs attention**, **In progress**, **Running** and **Paused**, with **All**, **Running** and **Paused** filters and **New box** in the header. A card shows the box's state, size, region, cpu, memory and disk, and whether it is in use, idle, or due to pause; hover to copy `prized ssh `, click to open the box. The cards are the boxes you own. In a [shared workspace](https://prized.dev/docs/workspaces), everyone else's sit under them in a folded **Team** section, each card naming its owner; it starts open when you own no box yet, and the state filters apply to it too. An owner's own cards also include any box no current member owns, such as a removed member's. Owners and members still open any box, from the Team section, by its link, on [Team activity](https://prized.dev/docs/teams#team-activity), or from the CLI. A [contractor](https://prized.dev/docs/teams#roles) sees only their own, with no Team section. ## New box [#new-box] **New box** on Boxes, or the **+** beside the workspace name; the summary card at the right holds **Create box**. | Control | What it does | | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Name | A fruit name is suggested; the dice picks another. No rename later. | | Start from | A [template](https://prized.dev/docs/snapshots#templates): the box boots that disk at the template's size. | | Region | Where the box runs ([Regions](https://prized.dev/docs/boxes#regions)), the region nearest you unless you pick another; the menu lists every region fastest first, by the round trip timed from your browser. A box from a template starts in the template's region. | | Size | Seven sizes, Nano to Extra Large, with prices. One your balance cannot keep running is refused, with the reason, unless the plan offer is checked ([Starting and resizing boxes](https://prized.dev/docs/billing#starting-and-resizing-boxes)). | | More options › Env vars | `NAME=value`, one per line ([Per-box vars](https://prized.dev/docs/environments#per-box-vars)). No default [environment](https://prized.dev/docs/environments) applies here; pass one from the CLI or API. | | More options › Restricted | Closes every credential channel to the box, permanently ([Safe for third parties](https://prized.dev/docs/environments#safe-for-third-parties)); locked on for a [contractor](https://prized.dev/docs/teams#roles). | | Plan offer | Owners see a checked **Switch to the $X/mo plan** when the box would outgrow the plan (uncheck to stay); with no plan and an empty balance, the button reads **Continue to checkout**. | | Create box | A refusal (a taken name, the box limit, too little balance, a [workspace policy](https://prized.dev/docs/teams#policies)) shows its reason under the button; a closing workspace shows no form. | ## The box page [#the-box-page] Tabs: **Overview**, **Terminal**, **Desktop**, **Metrics**, **Files**, **Snapshots**, **Settings**. On every tab the header carries **Pause** (or **Resume**) and a **…** menu with the other actions. ### Overview [#overview] The top line shows the state and since when (**Running for 2d 4h**, **Paused 3d ago**), and says so when a running box's report is more than two minutes late. Beside it: the `prized ssh` command (click to copy) and **Open terminal**, which reopens the way in you used last; its chevron lists them all: * **Terminal:** the browser terminal. * **Cursor**, **Terminal app:** that app on this computer, on the box, through the SSH stanza `prized setup` wrote ([Sessions](https://prized.dev/docs/sessions)). * **Claude Code**, **Codex:** the browser terminal in the agent's session (`claude` or `codex`), attached if `prized agents run` started it, an empty shell otherwise ([Agents](https://prized.dev/docs/agents)). Below it, two tiles and then **Activity**, the box's history: | Tile | Shows | Click | | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Machine | **Size**, **Disk** (**Storage** on an infinite-storage box), **Region**, the **Auto-pause** menu, **Pauses** (a set deadline), **Snapshots** (the last one, the schedule), **Rate**, **Created**, **Ports** | **Size** opens Resize (the box restarts on the new size, [Resizing](https://prized.dev/docs/boxes#resize)); **Region** opens Move, with more than one region ([Regions](https://prized.dev/docs/boxes#regions)); **Snapshots** opens its tab; a port opens its card | | Now | CPU, memory and disk as last reported, and **Up next**: an idle pause, a deadline, or a due snapshot | Opens Metrics | **Ports**, the Machine tile's last row, has a chip for every port the box is listening on and every port shared from it. A shared port's chip is blue with ↗ (outlined while nothing listens on it); shared ports come first, and past two rows the rest fold behind **N more**. Listening ports come from the box's own report, so a new server shows up within about a minute; a [zero data retention](https://prized.dev/docs/data-retention#zero-data-retention) workspace keeps no such report, so only its links show. Click a chip for its card: | Control | What it does | | ----------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Workspace**, **Link**, **Public** | Who can open the port: members of your workspace after signing in, anyone you send the link to, or anyone at all. An option you cannot pick is greyed out with the reason ([Share a port](https://prized.dev/docs/ports#share-a-port)). | | 1 day, 7 days, 30 days | How long a **Link** or **Public** share lasts. | | The button | Shares the port as picked: **Share with workspace**, **Create link for 7 days**, **Make public for 7 days**. On a shared port, picking someone else makes a new link and the old one stops working. | | Copy | Copies the link. A **Link** share's address is shown only right after it is made; afterwards **New link** replaces it with a fresh one. | | **Stop sharing** | Ends the link for everyone on it. | **+** at the end of the row shares a port nothing listens on yet. The **…** menu: **Open terminal**, **Snapshot now** ([Snapshots](https://prized.dev/docs/snapshots)), **Save as template…** ([Templates](https://prized.dev/docs/snapshots#templates)), **Copy box id**, **Settings**, and **Delete box…** (type `delete `; the undo is **Recently deleted**, [Deleting a box](https://prized.dev/docs/data-retention#deleting-a-box)). Forking is `prized fork` or the API ([Fork a box](https://prized.dev/docs/snapshots#fork-a-box)). A refused action shows its reason under the title; what each action does is on [Boxes](https://prized.dev/docs/boxes) and [Snapshots](https://prized.dev/docs/snapshots). ### Settings [#settings] | Section | Row | Control | | --------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Sleep | Auto-pause | The same menu as on the Overview. | | Sleep | Pause at | No deadline, 1, 4, 12 or 24 hours, or a custom window (`90m`, `36h`, `3d`), then **Set**; hidden while paused. | | Sleep | Quiet hours | **Exempt** (owner only), while the workspace has [quiet hours](https://prized.dev/docs/teams#quiet-hours). | | Access | Phone access | **Set up** shows host, port and username; **Generate password** shows it once, **Regenerate password** replaces it, **Revoke** removes it ([From your phone](https://prized.dev/docs/codex#from-your-phone)). | | Variables | Variables | **Edit** the per-box `NAME=value` list ([Per-box vars](https://prized.dev/docs/environments#per-box-vars)). | | Secrets | Mounts | **Mount** a secret [available to this box](https://prized.dev/docs/teams#scoped-secrets) under an env name, or **Unmount** one. Needs a running box; a restricted box refuses mounts. | | Danger | Delete box | The same typed confirmation as the menu. | ### Terminal [#terminal] The box's tmux session `main`, the one `prized ssh` opens: opening it wakes a paused box, and closing the tab loses nothing ([Sessions](https://prized.dev/docs/sessions)). * **Other sessions:** `?session=NAME` opens another session, created if missing. * **herdr:** on a box with [herdr](https://prized.dev/docs/herdr#from-the-dashboard-and-your-phone), **tmux** and **herdr** at the top right switch between the two; the browser remembers the pick per box, and `?mux=herdr` opens herdr directly. In herdr, an agent that finishes or needs you shows as a toast over the terminal. Very large notification messages are ignored to keep the terminal responsive. * **Copy:** select to copy (Cmd+C on a Mac, Ctrl+Insert or the right-click menu elsewhere); Ctrl+C goes to the shell. On a phone: * **Taps and drags:** a tap is a click (herdr's buttons, tmux's panes and status line, Claude Code's own) and a drag scrolls. * **The keyboard:** a tap on the line where the cursor is, such as Claude Code's prompt or a shell's, also brings the keyboard up; elsewhere the keyboard stays as it is. * **The key row:** the row under the terminal starts with the keyboard key, which brings the keyboard up and puts it away, then Esc, Tab, Ctrl, ^C and the arrows. Ctrl applies to the next key you type and brings the keyboard up for it: Ctrl then c is Ctrl+C, and Ctrl, b, then c opens a new tmux window (a new tab in herdr). ### Desktop [#desktop] Pick **Desktop** or **Browser**, then **Open desktop** or **Open browser** ([Desktop](https://prized.dev/docs/desktop)). ### Metrics [#metrics] Pick a range at the top right: **Last hour** is live; **Last 6 hours**, **Last 24 hours**, **Last 7 days** and **Last 30 days** are stored, drawn as an average with a max band, paused spans shaded and lifecycle events marked. Click a chart to pin a moment: the processes and listening ports below switch to the nearest stored snapshot (**Unpin** or Esc releases it). Live, the page also shows per-core load, interfaces, mounts and tmux sessions. The page never wakes a paused box; retention is on [Data retention](https://prized.dev/docs/data-retention#telemetry-retention-windows). ### Files [#files] A file browser as the box's login user, opening in your home directory (`~`); it needs a running box and never wakes one. * **Find a folder:** type a path in the filter (`~/projects` or `/var/log`, then Enter) or click the breadcrumb; **Display** holds the sort and **Show hidden files** (⌘⇧.). * **Change files:** a row's **…** menu has Open, Rename, Download and Delete…; **New folder** and **Upload** (or a drop on the listing) add to the folder. * **Uploads:** keep the local file unchanged until it finishes. A detected change cancels the upload. One that fails leaves any existing file of that name as it was; one that does not stop promptly ends the file-browser connection (**Reconnect** tries again). If the connection drops near the end of an upload, check the file before uploading it again. While a transfer runs, closing or reloading the tab asks first. Keys: ↑ ↓ move, Enter opens, Backspace goes up, `/` focuses the filter, Esc closes the file or clears the filter. A text file within the edit cap opens in an editor with **Save**; a bigger one shows its first megabyte read-only, and a binary file offers **Download**. Caps are on [Limits](https://prized.dev/docs/limits#commands-and-files). ## Snapshots [#snapshots] The box page's **Snapshots** tab lists its snapshots, newest first. Beside the heading: the [automatic schedule](https://prized.dev/docs/snapshots#automatic-snapshots) (every hour to every week, and how many to keep) and **New snapshot**. A row's **…** menu: **Restore into a new box**, **Make template**, **Delete** (**Cancel snapshot** while it is being taken); a template adds **New box from this template**, **Rename template** and **Drop template name** ([Snapshots](https://prized.dev/docs/snapshots)). ### Deleted [#deleted] The **Deleted** tab of Boxes: **Recently deleted** holds the undo copies of deleted boxes (**Restore the box**, **Delete now**); **Templates** lists templates whose source box is gone, with the same menu as above. ## Connectors [#connectors] One row per provider; **Connect** asks for a running box, the credential, the env name and, for ClickHouse, the HTTPS endpoint ([Connectors](https://prized.dev/docs/connectors)). ## Secrets [#secrets] **New secret** takes a name, a value, the allowed hosts (a name such as `OPENAI_API_KEY` fills in its provider's host), and **Available to**: **All boxes**, **Some boxes**, or **Members**. A row's **…** menu: **Details** (grants with **Revoke**, **grant a box**, **grant a member**, usage), **Rotate** (the placeholder stays, so mounted boxes keep working), **Delete**. Values are write-only once saved ([Secrets for agents](https://prized.dev/docs/credentials#secrets-for-agents), [Teams: Scoped secrets](https://prized.dev/docs/teams#scoped-secrets)). ## Workspace settings [#workspace-settings] Owner-only controls say so to members; while the workspace is closing, every control is read-only. | Page | Section | Rows | | ---------------- | ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | General | General | **Icon** (your domain's favicon until you **Upload** one; **Remove** clears it), **Name**, **Domain** (**Claimed**, then **Auto-join** and **Restrict membership**) ([Create one](https://prized.dev/docs/workspaces#create-one)) | | General | Cloud federation | **Connect** Amazon Web Services: **Open AWS** opens the console on a pre-filled stack; each connected role then shows **Connected**, **Check failed** (with the reason) or **Not verified**, with **Verify** and **Remove** ([AWS access](https://prized.dev/docs/aws)). Owner only; members read; not shown to contractors | | Members | Invite | **Invite link** (**Copy**, **New link**) ([Invite people](https://prized.dev/docs/workspaces#invite-people)) | | Members | Members | For the owner, a role select (**member** or **contractor**) and **Remove**; **Leave** on your own row ([Remove someone](https://prized.dev/docs/workspaces#remove-someone)) | | API keys | API keys | **New key** (named, shown once with a copy button); every key, one per signed-in machine plus any made for a script (a contractor's own), with **Revoke** and **Revoke all** ([API keys](https://prized.dev/docs/workspaces#api-keys), [Credentials Prized issues](https://prized.dev/docs/security#credentials-prized-issues)) | | Data and privacy | Data and privacy | **Zero data retention**: **Turn on** (typed confirmation) or **Turn off** on a [custom plan](https://prized.dev/docs/billing#custom-plans), **Talk to us** otherwise ([Zero data retention](https://prized.dev/docs/data-retention#zero-data-retention)) | | Data and privacy | Danger zone | **Close workspace** and **Erase now**, each confirmed by typing the workspace's name ([Closing a workspace](https://prized.dev/docs/data-retention#closing-a-workspace)) | ## Activity [#activity] Totals (boxes running, sessions attached, spend today and this cycle), then **Boxes** (owner, state, idle time, sessions, last prompt and exec, spend), **Members** (boxes, sessions, last active, spend; not shown to contractors), and **Recent** (the newest 50 audit rows, 15 a page). The terms are on [Teams: Team activity](https://prized.dev/docs/teams#team-activity). ## Policies [#policies] **Settings › Policies**. Each rule saves on its own; clear its field (or pick **Any size**) and save to turn it off. What each rule does is on [Teams: Policies](https://prized.dev/docs/teams#policies). | Section | Rows | | ------------- | --------------------------------------------------------------------------------------------------------------------- | | Member limits | **Spend per member**, **Boxes per member**, **Largest size per member**, **Auto-pause floor** | | Quiet hours | **Pause the workspace nightly**, then **Nightly from** and to, the days **On** and **All day on**, and a **Timezone** | | Audit log | **Retention**, in days | ## Audit log [#audit-log] **Settings › Audit log**. **SSH certificate issued** records a credential being issued, not a successful connection. Kinds, origins and the export contract are on [Teams: Audit log](https://prized.dev/docs/teams#audit-log). | Control | What it does | | ------------ | -------------------------------------------------------------------------------------------------------------- | | Filters | Member, box, kind, and range: 24 hours, 7 days (the default), 30 days, 90 days, or everything kept | | The table | When, member and credential kind, action, box, detail; client-reported rows say **reported**; 25 rows a page | | Download CSV | Every row of the current filters and range, up to 50,000 | | Export | Owner only: the [scheduled export](https://prized.dev/docs/teams#scheduled-export) destination, with its last delivery and error | ## Billing [#billing] **Settings › Billing**: everyone reads it; only the owner sees the controls. | Section | What it holds | | -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Top | The balance and how long it lasts, the plan and its renewal date, what your boxes cost around the clock | | Plan | A line when your boxes fit a smaller plan or outgrow this one; the ladder (**Choose**, **Upgrade now** or **Switch next cycle**, where a second click confirms and names what bills today); **Resume** while a cancel is scheduled; **Cancel plan** | | Credit | **Add credit** for a [top-up](https://prized.dev/docs/billing#topping-up), the [Overage](https://prized.dev/docs/billing#overage) switch, the rollover rule | | Boxes | Every live box with its size, state and hourly rate (a contractor's own) | | Recent activity | The last 50 ledger lines | | Payment and invoices | The Stripe portal: card, invoices, receipts ([Billing](https://prized.dev/docs/billing#choosing-and-changing-the-plan)) | ## Account [#account] Under **Settings**, **Account** is you, not the workspace. * **Profile:** your name, your email from your sign-in provider, and **Theme**: **System** (the default, following your OS), **Light** or **Dark**. * **Security:** **Sign-in methods** (Google and GitHub; **Connect** links another provider by its verified email, **Disconnect** unlinks any but the last) and **Sessions** (each browser and the network address it signed in from; **Sign out** one, or **Sign out other sessions**). API keys have their own page under [workspace settings](#workspace-settings); the sign-in model is on [Identity and access](https://prized.dev/docs/security#identity-and-access). ## Where a setting lives [#where-a-setting-lives] | Setting | Where | | -------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- | | Box name | New box, at create; no rename later | | Auto-pause | Box page, Overview or Settings, **Sleep** | | Pause deadline; a box's quiet hours exemption (owner) | Box page, Settings, **Sleep** (**Pause at**, **Quiet hours**) | | Size, region | Box page, Overview, **Size** and **Region** | | Per-box env vars | Box page, Settings, **Variables** | | Snapshot schedule | Box page, **Snapshots** tab | | Phone SSH password | Box page, Settings, **Access** | | Shared ports | Box page, Overview, the Machine tile's **Ports** row | | Secrets mounted on a box | Box page, Settings, **Secrets** | | Who a secret is available to, what it was spent on | Secrets, **Details** | | Environments (what new boxes inherit, the default, safe for third parties) | CLI `prized environments` or the API; not in the dashboard | | Workspace name, icon, domain | Settings, **General** | | AWS roles the boxes assume | Settings, **General**, **Cloud federation** (owner) | | Invite link, members, member roles (owner) | Settings, **Members** | | API keys and device SSH keys | Settings, **API keys** | | Spend and box caps, largest size, auto-pause floor, quiet hours, audit retention | Settings, **Policies** (owner) | | Audit export | Settings, **Audit log**, **Export** (owner) | | Plan, top-ups, overage, card, invoices | Settings, **Billing** (owner) | | Zero data retention, close, erase | Settings, **Data and privacy** | | Your name, light or dark theme | Settings, **Profile** | | Sign-in providers, browser sessions | Settings, **Security** | | CLI usage telemetry | Not in the dashboard: [CLI: usage telemetry](https://prized.dev/docs/cli#usage-telemetry) | | Dashboard analytics | Your browser's Do Not Track setting: [Privacy](https://prized.dev/docs/privacy#turning-it-off) |