# Dashboard > Every screen in the signed-in app at prized.dev/dashboard, what each control does, and where a setting lives. The feature pages explain the behaviour; this one says where to click. URL: https://prized.dev/docs/dashboard ## Layout [#layout] One sidebar and one page at a time. The sidebar lists the screens below (Cmd/Ctrl+B collapses it) and ends with the account row: the workspace name and your email, with **Switch workspace** and **Sign out**; on the [free credit](https://prized.dev/docs/billing#free-credit) it counts down what is left. The top bar carries the breadcrumb and **New box**, which rests as a **+** and shows its label when you point at it. A banner crosses the top when money needs attention ([When we tell you](https://prized.dev/docs/billing#when-we-tell-you)), while the workspace is closing (with **Reopen**), or when a signed-in machine runs a CLI too old to [update itself](https://prized.dev/docs/cli#updates). A card sits in the bottom-right corner until you have signed a machine in with `prized login`: the CLI [install command](https://prized.dev/docs/quickstart#2-install-the-cli), shown short and copied in full with your sign-in link, with a switch between the macOS or Linux and Windows shapes (the **x** hides it for two weeks). ## Screens [#screens] | Screen | Route | What you can do | Details | | ------------- | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------- | | Boxes | `/dashboard` | See every box, its state and vitals; copy its `prized ssh` command | [Boxes](https://prized.dev/docs/boxes) | | New box | `/dashboard/boxes/new` | Pick a size, name, template, environment and per-box vars; create | [Create](https://prized.dev/docs/boxes#create) | | Box: Overview | `/dashboard/boxes/` | Pause, resume, resize, move region, snapshot, fork, template, auto-pause, deadline, env vars, phone access, delete; the event log | [Boxes](https://prized.dev/docs/boxes) | | Box: Terminal | `/dashboard/boxes//terminal` | A shell in the box's tmux session | [Sessions](https://prized.dev/docs/sessions) | | Box: Desktop | `/dashboard/boxes//desktop` | A Linux desktop or one Chrome window, streamed | [Desktop](https://prized.dev/docs/desktop) | | Box: Monitor | `/dashboard/boxes//monitor` | 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 | | Box: Secrets | `/dashboard/boxes//secrets` | Mount and unmount the workspace secrets available to this box | [Secrets tab](#secrets-tab) below | | Snapshots | `/dashboard/snapshots` | Take, restore, delete, name templates; undo a box delete | [Snapshots](https://prized.dev/docs/snapshots) | | Environments | `/dashboard/environments` | Create and edit what new boxes inherit; upgrade boxes | [Environments](https://prized.dev/docs/environments) | | Filesystem | `/dashboard/filesystem` | Pick a running box to browse | [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) | | Workspace | `/dashboard/workspace` | Name, icon, domain, invite link, members and roles, CLI tokens, cloud federation, data and privacy, close, erase | [Workspaces](https://prized.dev/docs/workspaces) | | Activity | `/dashboard/workspace/activity` | What the team is doing now: running boxes, attached sessions, spend, recent actions | [Teams: Team activity](https://prized.dev/docs/teams#team-activity) | | Policies | `/dashboard/workspace/policies` | The rules that bind members: spend and box caps, largest size, auto-pause floor, quiet hours, audit retention | [Teams: Policies](https://prized.dev/docs/teams#policies) | | Audit | `/dashboard/workspace/audit` | Who did what; filter it, download a CSV, set up the scheduled export | [Teams: Audit log](https://prized.dev/docs/teams#audit-log) | | Billing | `/dashboard/billing` | Plan, balance, top-ups, overage, what each box burns, activity, the Stripe portal | [Billing](https://prized.dev/docs/billing) | | Settings | `/dashboard/settings` | Your name, sign-in providers, browser sessions | [Settings](#settings) below | ## Boxes [#boxes] `/dashboard` is a grid of cards, oldest first: name, state, shape (vCPU, RAM and disk), vitals, and the box's `prized ssh ` command (click to copy). Click a card to open the box. ## New box [#new-box] **New box**, the **+** in the top bar, opens `/dashboard/boxes/new`. | Control | What it does | | ----------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Size ladder | A size your balance cannot keep running is blocked with the reason, unless the plan offer is checked ([Starting and resizing boxes](https://prized.dev/docs/billing#starting-and-resizing-boxes)). | | Name | A fruit name is suggested. No rename later. | | Start from | A [template](https://prized.dev/docs/snapshots#templates), once you have one: the box boots that disk at the template's size. | | Environment | Your default is preselected; **none** gives the box no repos, script, vars or files ([Environments](https://prized.dev/docs/environments)). | | Env vars for this box | `NAME=value`, one per line ([Per-box vars](https://prized.dev/docs/environments#per-box-vars)). | | Restricted (safe for third parties) | Closes every credential channel to the box, permanently ([Safe for third parties](https://prized.dev/docs/environments#safe-for-third-parties)); a [contractor](https://prized.dev/docs/teams#roles) sees it on and locked. | | Plan offer | Owners see a checked **Switch to the $X/mo plan** when the box would outgrow the plan; uncheck it to stay. With no plan and an empty balance the button reads **Continue to checkout**. | | Create box | A taken name, the box limit, too little balance, or a [workspace policy](https://prized.dev/docs/teams#policies) is refused with the reason. A closing workspace shows no ladder. | ## The box page [#the-box-page] Six tabs: **Overview**, **Terminal**, **Desktop**, **Monitor**, **Files**, **Secrets**; the header shows the name, state, last heartbeat and the `prized ssh` chip. ### Overview [#overview] A card per topic, each row one setting: its name, a line saying what it does, and its control. **Machine** leads with the readout — the cpu, memory and disk meters, then size, disk, region and created. | Card | Row | Control | | --------------- | -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Power | Pause / Resume | One button whose verb follows the state. | | Power | Auto-pause | Off, or 30 minutes to 24 hours idle, with how long the box has been idle; a member's menu stops at the [auto-pause floor](https://prized.dev/docs/teams#policies). On the [free credit](https://prized.dev/docs/billing#free-credit) the row reads off and does not open: those boxes never auto-pause. | | Power | Pause at | No deadline, 1, 4, 12 or 24 hours, or a custom window (`90m`, `36h`, `3d`), then **Set**; hidden while paused. | | Power | Quiet hours | **Exempt** (owner only), shown while the workspace has [quiet hours](https://prized.dev/docs/teams#quiet-hours). | | Environment | Version | The pinned environment and version, and **Upgrade to vN** when a newer one exists. | | Environment | Variables | **Edit** opens the per-box `NAME=value` list. | | Environment | Restricted | Shown only on a restricted box; it is a fact, not a control. | | Size and region | Resize | A size card, then **Resize** (or **Resize and switch for $X today** when the size outgrows the plan). | | Size and region | Move region | A region, shown with more than one and off while a move is in flight. | | Backups | Snapshot, Save as template, Fork | A name, then the button; for a fork, an optional name, a size whose disk holds the copy, and whether to keep the copy as a snapshot. | | Backups | Automatic snapshots | A schedule from every hour to every week, and how many to keep. | | 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)). | | Access | Shared ports | **Share a port** lists the box's shared ports with their links and how often each was opened (a dot says whether something is listening there right now), then a selector of what is listening on the box, by port and process; pick one and **Share**, or **type a port** for one nothing is listening on yet. **Stop sharing** takes a link back ([Share a port with your team](https://prized.dev/docs/ports#share-a-port-with-your-team)). | | Danger zone | Delete box | Type `delete `; the undo is **Recently deleted** on Snapshots ([Deleting a box](https://prized.dev/docs/data-retention#deleting-a-box)). | A refusal shows under the cards in the server's own words. **Events** closes the page: the last 50 state changes with reason, actor and time. What each action does is on [Boxes](https://prized.dev/docs/boxes) and [Snapshots](https://prized.dev/docs/snapshots). ### Terminal [#terminal] The box's tmux session `main`, the same one `prized ssh` opens; closing the tab loses nothing, and opening it wakes a paused box ([Sessions](https://prized.dev/docs/sessions)). Select to copy (Cmd+C on a Mac, Ctrl+Insert or the right-click menu elsewhere); Ctrl+C goes to the shell. ### Desktop [#desktop] Pick **Desktop** or **Browser**, then **Open desktop** or **Open browser** ([Desktop](https://prized.dev/docs/desktop)). ### Monitor [#monitor] Ranges: **live**, **1h**, **6h**, **24h**, **7d**, **30d**; the stored ranges show averages and a max band, paused spans shaded, lifecycle events as ticks. Panels: cpu, memory, network, disk, ports · tmux, processes. Click a chart to pin a moment and the ports and processes panels show the nearest stored snapshot. The monitor 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; it needs a running box and never wakes one. Each row has **download**, **rename** and **delete**; a text file within the inline cap opens in an editor, a bigger one shows its head read-only, a binary file offers download. Caps are on [Limits](https://prized.dev/docs/limits#commands-and-files). ### Secrets tab [#secrets-tab] Each mount with **Unmount**, then a secret picker, an env name and **Mount**. The picker lists only the secrets [available to this box](https://prized.dev/docs/teams#scoped-secrets); a mount whose grant was revoked shows **no longer granted** until you unmount it. Mounts need a running box, and a restricted box refuses them. ## Snapshots [#snapshots] **New snapshot** picks a box, a name and a description; the table lists every snapshot with kind, box, size, status and age. Per row: **Restore** (an optional name for the new box), **Make template** or **Rename**, and **Delete** then **Confirm delete**. The **templates** list offers **new box from this** and **Drop name**; **recently deleted** holds the undo copies of deleted boxes with **Restore** and **Delete now** ([Snapshots](https://prized.dev/docs/snapshots)). ## Environments [#environments] One card per environment with **Make default**, **Edit**, and **Delete** (type `delete `). **New environment** asks for a name, description, base size, env vars, a setup script, and **Make it the default for new boxes**. **Edit** opens sections that save on their own: General, the credentials a box may receive (**Safe for third parties**, or **Secret mounts**, **Device keys**, **Phone access** one at a time), env vars, secret files (shown as path, mode and size only), repos, and Versions with **Upgrade N boxes to vX** ([Environments](https://prized.dev/docs/environments)). ## Connectors [#connectors] One card 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] **Add secret** asks for a name, the value, the allowed hosts, a description, and **Available to** (all boxes, selected boxes, or selected members' boxes). Per row: **Rotate** (the placeholder stays, so mounted boxes keep working), **Delete** then **Confirm delete**, and **Details** (grants with **Revoke**, **grant a box**, **grant a member**, and the usage table). 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 [#workspace] Owner-only controls say so to members; while the workspace is closing every control is read-only. | Card | Rows | | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Workspace | **Icon** (**Upload**, **Remove**, **Use domain favicon**), **Name** and **Save**, **Domain** (**Claimed**, then **Auto-join** and **Restrict membership**), **Invite link** (**Copy**, **New link**) ([Create one](https://prized.dev/docs/workspaces#create-one), [Invite people](https://prized.dev/docs/workspaces#invite-people)) | | Members | A role select (**member** or **contractor**) and **Remove** for the owner; **Leave** on your own row ([Remove someone](https://prized.dev/docs/workspaces#remove-someone)) | | CLI tokens | Every signed-in machine (a contractor's own) with last use, CLI version and whether it registered an SSH key; **Revoke** per row, **Revoke all** ([CLI tokens](https://prized.dev/docs/workspaces#cli-tokens), [Credentials Prized issues](https://prized.dev/docs/security#credentials-prized-issues)) | | Cloud federation | One row per provider (**Amazon Web Services** today); **Connect** names the two console clicks, then **Open AWS** opens the console on a pre-filled stack and the card waits for it to report back (**Copy link**, **Cancel**); one row per connected role with its status (**Connected**, **Check failed** with the reason, **Not verified**), **Verify**, **Remove** then **Confirm remove** ([AWS access](https://prized.dev/docs/aws)). Owner only; members read; not shown to contractors | | Data and privacy | **Zero data retention**: **Turn on** (typed confirmation) or **Turn off** ([Zero data retention](https://prized.dev/docs/data-retention#zero-data-retention)) | | 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] **Now** (boxes running, sessions attached, spend today and this cycle), **Boxes** (each live box with owner, state, idle time, sessions, last prompt and exec, spend), **Members** (not shown to contractors), and **Recent** (the newest 50 audit rows); terms are on [Teams: Team activity](https://prized.dev/docs/teams#team-activity). ## Policies [#policies] The owner edits, members read. Each rule saves on its own, and its value is its switch: clear the field (or pick **Any size**) and save to turn a rule off. | Card | Rows | | ------------- | --------------------------------------------------------------------------------------------- | | Member limits | **Spend per member**, **Boxes per member**, **Largest size per member**, **Auto-pause floor** | | Quiet hours | **On**, then the nightly window, the weekday and all-day checkboxes, and a timezone | | Audit log | **Retention**, in days | The rules themselves are on [Teams: Policies](https://prized.dev/docs/teams#policies). ## Audit [#audit] | Control | What it does | | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Filters | Member, box, kind (grouped by area), and range: last 24 hours, 7 days (the default), 30 days, 90 days, or everything kept | | The table | When, member with the credential kind beneath, action, box, detail; client-reported rows carry a muted **reported** label; **Load more** pages 100 at a time | | Download CSV | Every row of the current filters and range, up to 50,000 | | Export | Owner only: a URL and a write-only secret, with a status line showing the last delivery and error | Kinds, origins and the export contract are on [Teams: Audit log](https://prized.dev/docs/teams#audit-log). ## Billing [#billing] Everyone reads this page; only the owner sees the controls. **Plan**: the current plan and renewal date, a nudge when your boxes fit a smaller plan or outgrow this one, and the plan cards (**Choose**, **Upgrade now** or **Switch next cycle**, **Cancel plan**, **Resume this plan**). **Balance**: the balance and how long it lasts, **Add credit once** for a [top-up](https://prized.dev/docs/billing#topping-up), and the [Overage](https://prized.dev/docs/billing#overage) checkbox. Then **What you're burning** (every live box and its hourly rate; a contractor's own), **Recent activity** (the last 50 ledger lines), and **Manage in Stripe** for the card, invoices and receipts ([Billing](https://prized.dev/docs/billing#choosing-and-changing-the-plan)). ## Settings [#settings] Your account, not the workspace: **Profile** (**Name** and **Save**, plus your email and photo, both from your sign-in provider), **Sign-in methods** (Google and GitHub: **Connect** links another provider by its verified email, **Disconnect** unlinks one, never the last), and **Sessions** (each browser with the network address it signed in from; **Sign out** per browser, or **Sign out other sessions**). CLI tokens live under [Workspace](#workspace); 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, pause deadline | Box page, Overview, **Auto-pause** and **Pause at** | | Size, region | Box page, Overview, **Size and region** | | Per-box env vars, environment version | Box page, Overview, **Environment** (**Variables**, **Version**) | | Snapshot schedule | Box page, Overview, **Automatic snapshots** | | Phone SSH password | Box page, Overview, **Phone access** | | Secrets mounted on a box | Box page, **Secrets** tab | | Quiet hours exemption for a box | Box page, Overview, **Quiet hours** (owner) | | Who a secret is available to, what it was spent on | Secrets, **Details** | | Default environment, safe for third parties | Environments | | Workspace name, icon, domain, invite link, members | Workspace | | Member roles | Workspace, **Members** (owner) | | Spend and box caps, largest size, auto-pause floor, quiet hours, audit retention | Policies (owner) | | Audit export | Audit, **Export** (owner) | | AWS roles the boxes assume | Workspace, **Cloud federation** (owner) | | CLI tokens and device SSH keys | Workspace, **CLI tokens** | | Zero data retention, close, erase | Workspace, **Data and privacy** and **Danger zone** | | Plan, top-ups, overage, card, invoices | Billing (owner) | | Sign-in providers, browser sessions | Settings | | 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) |