The dashboard
A tour of the Alaf Server 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 Alaf Server 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
Navigation links
The links are grouped into labelled sections — Main, Settings, and (on self-hosted instances) Infrastructure.
| Section | Item | Route | What's there |
|---|---|---|---|
| Main | Home | / | The overview page (below) — your projects, quick links, and recent activity. |
| Main | Projects | /projects | Every project in the workspace. Click one to open its detail view. See Projects. |
| Main | Deployments | /deployments | A feed of every build across your projects. See Rollback & redeploy. |
| Main | Backups | /backups | Register the storage targets your backups write to. See Backups. |
| Settings | Settings | /settings | Account, team, GitHub connection, tokens, and MCP. See Settings. |
| Settings | Billing | /billing | Plan and usage — shown on Alaf Server Cloud (or a cloud-connected instance). See Billing. |
| Infrastructure | Servers | /servers | Your own connected machines to deploy onto. See Servers. |
| Infrastructure | Emails | /emails | The 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 Alaf Server 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 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
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.
Quick links
Under the projects panel is a row of four shortcut cards:
| Card | Goes to | For |
|---|---|---|
| Import Git | /library | Starting a project from a repository. |
| MCP Deploy | /settings?tab=mcp | Connecting an AI agent to deploy for you — see MCP. |
| Settings | /settings | Your account and team. |
| Docs | Opens the docs | This 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:
Projects
The projects list and a project's detail view and tabs (the tab whose URL is 'runtime' is labelled Configuration).
Library
Start a deployment from a repo, a local folder, a URL, or a template.
Deployments & rollback
Redeploy, roll back, and read what happened on the build screen.
Backups
Register S3, SFTP, an existing server, or local disk as backup destinations.
Servers
Connect your own machines to deploy onto (self-hosted only).
Email & webmail
The self-hosted mail stack and Zero webmail (self-hosted only).
Settings
Account, team, GitHub connection, tokens, and MCP.
Billing
Plan and usage on Alaf Server Cloud.