Dashboard

The dashboard

A tour of the Openship dashboard — the sidebar that navigates everything, the home overview, and a map to each area.

The dashboard is your home base. It's a single screen split in two: a sidebar down the left that navigates everywhere, and a large main area on the right that shows whatever you picked. There's no top navbar to hunt through — if you want to go somewhere, it's in the sidebar.

This page orients you to the whole thing: what each sidebar link opens, what the home page is telling you, and where to click next.

The sidebar

The sidebar is the rounded panel pinned to the left edge. It stays put as you move around, and the item for the page you're on is highlighted so you always know where you are.

At the very top you get the Openship logo and name, plus two small buttons:

  • A theme toggle (sun / moon) that flips the whole dashboard between light and dark.
  • A collapse button ("Collapse sidebar") that shrinks the panel to just icons to give the main area more room. Press it again ("Expand sidebar") to bring the labels back.

Screenshot

The full sidebar expanded: logo + name and the theme / collapse buttons at top, the three nav sections, the New Project button, and the workspace switcher at the bottom. (screenshot pending)

The links are grouped into labelled sections — Main, Settings, and (on self-hosted instances) Infrastructure.

SectionItemRouteWhat's there
MainHome/The overview page (below) — your projects, quick links, and recent activity.
MainProjects/projectsEvery project in the workspace. Click one to open its detail view. See Projects.
MainDeployments/deploymentsA feed of every build across your projects. See Rollback & redeploy.
MainBackups/backupsRegister the storage targets your backups write to. See Backups.
SettingsSettings/settingsAccount, team, GitHub connection, tokens, and MCP. See Settings.
SettingsBilling/billingPlan and usage — shown on Openship Cloud (or a cloud-connected instance). See Billing.
InfrastructureServers/serversYour own connected machines to deploy onto. See Servers.
InfrastructureEmails/emailsThe self-hosted mail stack and Zero webmail. See Emails.

Some links only appear in certain setups

The sidebar adapts to your instance. Billing shows only on Openship Cloud or a self-hosted instance that's connected to Cloud. Servers and Emails show only on a self-hosted instance. So a plain cloud account and a self-hosted box won't see exactly the same list — that's expected.

New Project

Just below the navigation is the bright New Project button. It takes you to the Library (/library), where you start a deployment — from a GitHub repo, a local folder, a URL, or a template. It's the same place the "Import Git" shortcut on the home page leads to.

Deploying for the first time?

Start with Deploy from GitHub — it walks the New Project → Library → Deploy flow click by click.

Workspace switcher

At the bottom sits the Account area. If you belong to more than one organization, this is a workspace switcher: it shows the active organization's name (and either "N workspaces" or your email underneath). Click it to open a popover titled Switch organization, pick another org, and the dashboard reloads scoped to it. The current org is marked Current with your role beside it.

That same popover holds your signed-in identity and the Log out button. (On the desktop app the button reads Back to setup instead, which returns you to the local setup screen.)

Screenshot

The workspace switcher popover open: the org list with a Current badge and role, the signed-in-as row, and the Log out action. (screenshot pending)

The home page

Clicking Home (or the logo) lands you on the overview at /. It opens with a greeting — "Good morning / afternoon / evening" with your first name — and the subtitle "Here's what's happening across your projects". The body is a two-column layout.

Screenshot

The home overview: greeting header, the Your Projects panel and shortcut cards on the left, and the sticky Activity / Recent column on the right. (screenshot pending)

Your Projects

The main panel is Your Projects — the projects in this workspace with a count and a View all link to /projects. It lists up to six; if you have more, a "View all N projects" link sits at the bottom. Click any row to open that project.

If you have no projects yet, this panel becomes a welcome card ("Launch your first project") with two buttons — Create project and Import from GitHub — both of which take you to the Library to get started.

Under the projects panel is a row of four shortcut cards:

CardGoes toFor
Import Git/libraryStarting a project from a repository.
MCP Deploy/settings?tab=mcpConnecting an AI agent to deploy for you — see MCP.
Settings/settingsYour account and team.
DocsOpens the docsThis documentation, in a new tab.

Activity and recent

The right-hand column is sticky (it follows you as the left side scrolls) and summarises the workspace at a glance:

  • Activity — a small scoreboard: total Projects, total Deployments, and your overall build Success rate (green when healthy, amber or red when it needs attention).
  • A contextual tip card ("Quick Tip") that changes with your state — connect GitHub, create your first project, or open project settings; once GitHub is linked it shows your connected account instead.
  • Recent — your latest projects, each with a coloured status dot, its status label, and how long ago it changed. Click one to jump straight into it.
  • An All systems operational note once you have active projects running.

A map of the dashboard

Each area has its own page or guide with the details. Here's where to go next:

On this page