Server Management #

Starting and stopping #

Dashboard controls #

• Start — starts your Hagency Server container
• Stop — gracefully shuts down the container (data preserved)
• Restart — stop + start in sequence

Status indicators #

Status	Meaning
Running	Server is online and accepting connections
Stopped	Server is offline; you can start it again at any time
Pending	Server is being provisioned
Migrating	Server is being moved to another node
Error	Something went wrong — check notifications or contact support
Suspended	Account issue — check billing or contact support

Settings #

Open Settings → Workspace.

Registration #

Toggle Allow Registration to control whether new users can sign up directly on your Hagency Server.

Federation #

Enable Federation to connect with the wider Matrix network (available on all plans).

When federation is on, users on other Matrix servers can message your users and join your rooms.

Upload size #

Configure the maximum file size for uploaded Matrix media (images, videos, documents).

Matrix ID domain #

Setup #

1. Go to Settings → Workspace → Matrix Server Name.
2. Enter the domain you want users to see in Matrix IDs, such as example.com.
3. Open Matrix Well-Known Domain on the same page.
4. Download the generated /.well-known JSON files.
5. Publish them on your domain:
   • https://example.com/.well-known/matrix/server
   • https://example.com/.well-known/matrix/client
6. Click Validate Published Files.

You do not need to point the domain at Hagency or add special A, CNAME, or TXT records for this flow.

If these two URLs are served through your existing website or reverse proxy, correct JSON is not enough on its own. Make sure they also return Content-Type: application/json; for /.well-known/matrix/client, return Access-Control-Allow-Origin: * as well. Otherwise the dashboard check may pass while browser clients such as app.element.io still fail.

Validation status #

The dashboard shows whether:

• /.well-known/matrix/server matches the expected value
• /.well-known/matrix/client matches the expected value

Changing the domain #

Set the Matrix ID domain before you create the first real Matrix user. After the first human user exists, the Matrix server_name is locked.

For the full /.well-known flow, see the detailed Matrix domain guide.

Backups #

Backups run automatically on a daily schedule when enabled by the platform.

What is backed up #

• PostgreSQL database (all Matrix data)
• Media files
• Server configuration

Manual backup #

Open a support ticket from your dashboard to request an immediate backup.

Webhooks #

Hagency supports workspace webhooks for integrating your workspace lifecycle and operational events with external systems.

Typical use cases #

• Send workspace events into your incident channel
• Trigger internal automation when a workspace changes state
• Forward billing or operational alerts into your own tools

Current status #

Webhook delivery, retry tracking, and event history are implemented in the backend. Tenant-facing UI entrypoints are being completed, so some webhook management may still require operator assistance.

Resource monitoring #

The dashboard shows live metrics for your server.

Usage panel #

• CPU — current CPU usage percentage
• Memory — current memory usage in MB
• Disk — total database + media storage in GB
• Matrix Users — number of registered users on your server
• Media — uploaded file storage

Usage alerts #

Hagency sends alerts as you approach plan limits:

• 80% used — warning
• 90% used — urgent: free space or upgrade
• 100% used — uploads are paused until space is freed or the plan is upgraded

Notifications #

Customize which notifications you receive at Settings → Notifications.

Channels #

Channel	Description
In-app	Always enabled — shown in the dashboard bell
Email	Sent to your verified email address

Categories #

You can configure notifications for:

• Billing and subscription events (renewals, payment failures)
• Server status changes (started, stopped, errors)
• Security alerts (new sign-in, password changes)
• Storage and resource warnings
• System announcements

Managing notifications #

• View all notifications via the bell icon in the header
• Mark as read — click a notification or use Mark all as read
• Delete — remove individual notifications or bulk-delete read ones

Old notifications are pruned automatically after a configured retention period.

Upgrading #

If you are hitting plan limits:

1. Go to Settings → Billing.
2. Click Upgrade.
3. Pick a Starter, Pro, or Enterprise plan.
4. Complete payment — your limits increase immediately.