Self-hosting guide

Give users a clean path to their own Matrix node.

The safest pattern is a dedicated subdomain like matrix.yourdomain.com. Run the installer, sign into Meshly with the admin account it creates, and only turn on public registration if you truly need it.

Step 1. Choose the right host

Use a dedicated Matrix subdomain. It keeps DNS simple, works with Meshly's current homeserver handling, and avoids the extra delegation work of using a root domain.

Good:   matrix.yourdomain.com
Avoid:  yourdomain.com if you do not want to manage Matrix delegation
Avoid:  yourdomain.com/matrix because Meshly expects /_matrix at the host root

Step 2. Run the installer

The bare command prompts for domain, email, and admin credentials. This is the simplest version for end users.

curl -fsSL https://meshly.chat/install/meshly-node.sh | sudo bash

For a fully scripted rollout, pass explicit flags:

curl -fsSL https://meshly.chat/install/meshly-node.sh | sudo bash -s -- \
  --domain matrix.yourdomain.com \
  --email ops@yourdomain.com \
  --admin-user owner \
  --open-registration false \
  --yes

Step 3. Sign in from Meshly

Open Meshly and choose Use my own homeserver.
Enter https://matrix.yourdomain.com.
Choose Sign in, not Create account, if you left registration disabled.
Enter the admin username and password created during the install.

Step 4. When to enable registration

Turn on --open-registration true only if you really want people creating accounts directly from Meshly. It is convenient, but it also raises spam and moderation risk on an internet-facing homeserver.

Need to verify the install?

Run the checklist right after DNS and TLS settle.

Open the checklist See the official deployment