Guides
On this page
Task guides, grouped by who does them.
The pages below are being written. Each one becomes a link once it's reviewed.
Run your server
Section titled "Run your server"- Upgrade your server:
sudo moorhold upgrade - Updates in the portal: check, ask, approve
- Backups: on by default; keep the key
- Restore from a backup: one database or the lake
- Roll back an upgrade: back to the rollback point
- Give an app more memory: new in 2026.10.10
- Edit and apply the Stack:
sudo moorhold apply - Check your server's status:
moorhold status - Start and stop Moorhold:
moorhold.service - Manage the access key: set or forget it
- Reset a password: from the server or the portal
- Move to another hostname:
--change-hostname - Connect through a relay: for home networks
- Set up mail: the Mail page and
sudo moorhold mail password - Check your server's plan:
sudo moorhold plan
People and access
Section titled "People and access"- Which account to use: new in 2026.10.10
- Sign in and sign out: one account across the tools
- Connect your organisation's sign-in: Entra ID, Google, Okta
- Groups and permissions: what each group can do in each tool
- The local admin: break-glass sign-in
Work with data
Section titled "Work with data"- Sample data: add or remove it
- Postgres sources: why a database source can't connect on an installed server
- Add a web service, with root on the server
- Data checks and marts: declared checks, served marts
- Find data and lineage: search in the portal, and lineage on a Stack with DataHub
- Trino's tables in DataHub: working from 2026.10.10
AI agents
Section titled "AI agents"- Connect an agent: the portal's MCP server
- Propose and approve changes: four eyes
- Audit agent activity: what agents did