Docs / Getting started

Setting it up

The plain-English walkthrough for getting your own copy of mustr running on Cloudflare’s free tier. No coding, about 45 minutes and a domain name.

The honest bar
  • About 45 minutes, once.
  • A domain name, roughly $10–15 a year — the only guaranteed cost.
  • A lot of clicking buttons and pasting values this guide hands you. No coding.
  • If a step doesn't work, re-read the step. There's no support desk on the other end — this guide is it.

What you'll need before you start

Not on the list: a server to rent, a monthly subscription, or software to install locally. mustr lives entirely on Cloudflare's free tier — see the cost & terms breakdown for the receipts.

The 30-second picture

You'll end up with four things talking to each other:

1. A domain

Your address on the internet, like yourclan.gg. Rented yearly from a registrar.

2. Cloudflare

The free service that runs mustr and holds your data.

3. A Discord app

An ID card so mustr can read your server's roles and post events. Not your server — an identity mustr wears.

4. mustr itself

The website, running on Cloudflare, wearing that ID card, reachable at your domain.

Order: domain → Cloudflare → Discord app → deploy mustr → point the domain at it → flip it on with the setup wizard. Every value you copy, this guide says exactly where it goes, and the wizard at the end prints the URLs you need.

The walkthrough

1

Get a domain name

A domain is the something.gg people type to reach you. You rent it, yearly, from a registrar. Any reputable one works — a plain .com is never wrong, and .gg is popular with gaming groups.

Resist the checkout upsell. You'll be tempted to buy hosting or a site builder. Don't — you already have all of that coming, for free.
2

Make a Cloudflare account and add your domain

  1. Sign up for a free Cloudflare account and confirm your email.
  2. Find "Add a domain" and type the one you just bought.
  3. Cloudflare gives you two "nameservers" (like something.ns.cloudflare.com). Copy them.
  4. Back at your registrar, find the "Nameservers" setting and replace what's there with Cloudflare's two.
  5. Return to Cloudflare and let it check — this can take minutes to a few hours. It'll email you when ready.
Plain English

You just told the internet "Cloudflare is in charge of my domain now." That's all nameservers do.

3

Create your Discord application

The fiddliest part. Go slow, and keep a notepad open — you'll paste these values back in during Step 6.

  1. In Discord's Developer Portal, click "New Application." Name it anything.
  2. On the main page, copy the Application ID (Client ID) and Public Key.
  3. Open "OAuth2" and copy the Client Secret (Reset Secret if none is shown). Treat it like a password.
  4. Open "Bot," add one if prompted, then Reset Token and copy the Bot Token. Also a password.
  5. Still in Bot, turn ON "Server Members Intent." mustr needs it to see who's in your server. Leave the rest off.
  6. Get your Server ID: in Discord, enable Developer Mode (User Settings → Advanced), then right-click your server icon → Copy Server ID.

By the end you have five things: Application ID, Public Key, Client Secret, Bot Token, Server ID. Don't invite the bot yet — it has nothing to join until mustr is running.

4

Deploy mustr to Cloudflare

⚡ Deploy to Cloudflare

  1. Click it, sign in with your Cloudflare account, and let it connect your GitHub — it makes you your own copy of mustr.
  2. On the setup screen, Cloudflare creates your database and file storage automatically and asks for two values to invent. Make both long and random, letters and numbers only:
    • SETUP_TOKEN — unlocks the setup wizard in Step 6. Keep this one.
    • SESSION_SECRET — keeps logins secure. Set it and forget it.
  3. Hit deploy and wait a minute. mustr is now live at a temporary address like mustr.your-name.workers.dev.
5

Point your domain at mustr

  1. In the Cloudflare dashboard: Workers & Pages → your new mustr worker → Settings → Domains & Routes.
  2. Add → Custom Domain, type your domain, confirm. Cloudflare handles DNS and the certificate.

Give it a minute, then open your domain — you should see mustr's setup wizard waiting.

6

Turn it on: the setup wizard

  1. Visit your domain — you'll get a "Let's set up mustr" screen.
  2. Unlock: paste the SETUP_TOKEN from Step 4. This proves you're the owner and quietly builds your database tables.
  3. Identity & Discord: enter your site name and the five values from Step 3. The screen also shows the exact redirect URL and interactions URL — copy each into the Developer Portal, then hit "Check my Discord settings." Green means good.
  4. Claim ownership: click "Sign in with Discord." You become the top-rank owner with full control, and the wizard locks itself for good.
7

Your first hour as an owner

  1. Invite the bot. Settings → Identity & Discord has a ready-made invite that asks for only the permissions mustr uses (never Administrator). See what the bot can and can't do.
  2. Set your look: Admin → Theme & Branding.
  3. Build your ranks to match your group: Admin → Ranks & Roles.
  4. Make your home page: Admin → Pages.
  5. Tell your members to sign in with Discord. If they're in your server, they're in — no new passwords.

The clean break

After this, you own it outright. No subscription, no license server phoning home, no support desk. Your mustr runs on your Cloudflare, with your data, under your control. That independence is the point — nobody can rug-pull a site that only depends on your own accounts. The flip side: when something confuses you, this guide and the rest of the wiki is the answer, not a ticket.

Quick glossary

Domain / registrar: your web address, and the company you rent it from.
Cloudflare: the free service that runs mustr and stores your data.
Worker: Cloudflare's name for a running app. mustr is a Worker.
D1 / R2: Cloudflare's free database and file storage — roster in D1, images in R2.
Nameservers: the setting that says "Cloudflare is in charge of my domain."
SETUP_TOKEN: a one-time password you invent to claim ownership on day one.

If something's stuck