Reference

Admin UI

A guided tour of the Astrodock dashboard — the web app at admin.<your-domain> where you run the whole platform. This is the "where do I click to…" reference: one stop per page, with what each is for.

Who this is for

The dashboard is for admins — the people running the platform. It's a different thing from the apps you deploy and the people who log into them. See Manage users & access for that distinction.

Login

Open https://admin.<your-domain> (or http://admin.localhost locally) and sign in with the admin email and password from your .env (ASTRODOCK_ADMIN_EMAIL / ASTRODOCK_ADMIN_PASSWORD). That admin account is seeded on first boot.

Apps

The home of the dashboard. The Apps page lists every app on the platform with its subdomain and current status, and it's where you create a new app.

Click an app to open its detail view, which is organised into tabs. Here's what each tab is for.

Settings

The app's core configuration: its name, subdomain, source repo and branch, auth mode, and its database/storage modes. This is where you change where an app is served or which GitHub repo it deploys from.

Env vars

The app's environment variables — the values your app reads at runtime. Set, edit, and remove them here; secret values are stored encrypted and masked in the UI. If a required variable is missing, a deploy is blocked until you fill it in.

Also settable from the CLI

You can set the same variables with astrodock from your terminal. See Secrets & env vars.

Deploys

The deployment history for this app — each build, when it ran, and whether it succeeded. Trigger a new deploy and open a past one to inspect it.

Logs

The live log stream for the running app, plus build output. This is your first stop when an app misbehaves after deploy.

Process status

Alongside the tabs, the app detail view shows the app's current process status — whether it's running, stopped, or crashing — so you can tell at a glance if it's healthy. From here you can restart it.

Users

Manage the end-users who log into your apps: create and edit them, reset passwords, grant or revoke per-app access, and toggle their active/admin flags. This page only affects apps that use platform login.

Full walkthrough: Manage users & access.

Pages

Host one-off documents, static mini-sites, and file shares — no repo or deploy. List and toggle pages, then open a page to manage its files (upload, in-browser editor, set the entry file), control access (public, passkey, or platform login), enable a small saved-data blob, and grab share links.

Full walkthrough: Host documents & mini-sites.

Activity

A recent-history feed combining deployments and auth logs — so you can see at a glance what's been shipped lately and who's been logging into your apps (including failed attempts).

Health

The status board. Shows each app as up or down and reports server metrics for the host. If you've configured email alerts, this is the same monitoring that emails you when an app goes down or recovers.

Want the down/recovery emails? See Email notifications.

Tokens

Create and revoke API tokens — the scoped credentials the astrodock CLI (and AI agents) use to talk to the platform. A new token's value is shown only once, so copy it when you create it.

More on these: API tokens.

Related