mustr
Setup guide

Setting up mustr, minus the jargon.

The whole walkthrough, assuming you've never written code or opened a "terminal." If you can run a Discord server and follow numbered steps, you can do this. Read it once before you touch anything.

Start the walkthrough What is mustr? →
~45 min,once No coding ~$10/yrdomain, the only cost ~$0to host

First: is this actually for you?

Let's save us both some time. mustr is self-hosted, a nerdy way of saying you run it, on your account, and nobody sends you a bill or a support email. Including me. That's the deal, and it's a good one, but it means the setup is on you.

The honest bar

If that sounds fine, you're exactly who this is for. If "buy a domain and paste some settings" already sounds like a bad afternoon, mustr honestly might not be your fit, and that's okay. No hard feelings.

What you'll need before you start

Grab these first so you're not stopping halfway.

Notably not on the list: a server to rent, a monthly subscription, or any software to install on your computer. mustr lives entirely on Cloudflare's free tier. Want the receipts on "it's free"? That's what the cost & legal breakdown is for.

The 30-second picture

You'll end up with four things talking to each other. You don't need to understand them deeply. Just know the names so the steps make sense.

1A domain

Your address on the internet, like yourclan.gg. You rent it yearly from a registrar.

2Cloudflare

The free service that actually runs mustr and holds your data. The landlord and the building.

3A Discord app

A little robot ID so mustr can read your server's roles and post events. Not your server, an ID card mustr wears.

4mustr itself

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

Order: domain → Cloudflare → Discord ID → put mustr on Cloudflare → hand it the ID → point the domain at it → flip it on with the setup wizard. Every value you copy, I'll tell you where it goes, and the wizard at the end literally 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 company called a registrar.

  1. Buy a domain from a registrar. Any reputable one works. If you'd like a suggestion, I used Porkbun for mustr.gg and it was painless. No upsells, honest pricing. To be clear: I'm not affiliated with them, I earn nothing if you use them, and I can't help you with anything on their end. It's just where I had a good experience.
  2. Choose a name that's short and yours. .gg is popular with gaming groups; a plain .com is never wrong.
  3. Pay for it. You do not need the add-ons they'll upsell: no "web hosting," no "site builder," no "email hosting." mustr is your hosting.
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

Cloudflare is the free service that runs mustr. Already have an account? Skip to sub-step 2.

  1. Sign up for a free Cloudflare account and confirm your email.
  2. Find "Add a domain" (sometimes "Add a site") and type the domain you just bought.
  3. Cloudflare gives you two "nameservers". They look like something.ns.cloudflare.com. Copy them.
  4. Go back to your registrar, find the "Nameservers" setting (often under DNS), and replace what's there with Cloudflare's two.
  5. Return to Cloudflare and let it check. This handoff takes anywhere from a few minutes to a few hours. That's normal, and out of everyone's hands. It'll email you when it's 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 (mustr's ID card)

The fiddliest part. Go slow. You're making a robot identity mustr wears to talk to your server. Keep a notepad open; you'll paste these values in Step 5.

  1. In Discord's Developer Portal, click "New Application." Name it anything (your clan + "site" is fine).
  2. On the main page, copy two values to your notepad: Application ID (a.k.a. Client ID) and Public Key.
  3. Open "OAuth2" and copy the Client Secret (you may have to "Reset Secret" to reveal one). Treat it like a password.
  4. Open "Bot," add a bot if prompted, then "Reset Token" and copy the Bot Token. Also a password.
  5. Still in Bot, turn ON the "Server Members Intent" toggle. mustr needs it to see who's in your server. Leave the others off.
  6. Get your Server ID: in Discord (not the portal), enable Developer Mode (User Settings → Advanced), then right-click your server icon → "Copy Server ID."

By the end your notepad has 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.

Two URLs you'll need soon. The portal also wants a "redirect URL" and an "interactions endpoint URL." Don't guess them. The setup wizard (Step 6) shows you the exact ones and where they go. We'll come back here then.
4

Deploy mustr to Cloudflare

This is the magic button. It builds everything for you. No terminal, no config files.

⚡ Deploy to Cloudflare

  1. Click it, sign in with your Cloudflare account from Step 2, 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 you to invent two passwords. Make both long and random: letters and numbers only (symbols like + or / can get mangled by the form):
    • SETUP_TOKEN: unlocks the setup wizard in a moment. Keep this one; you'll paste it in Step 6.
    • SESSION_SECRET: mustr uses it to keep logins secure. Set it and forget it.
  3. Hit deploy and wait a minute. When it finishes, mustr is live at a temporary address like mustr.your-name.workers.dev.
That's the hard part, done. One button built your app, its database, and its storage. Everything from here is just filling in your details.
5

Point your domain at mustr

Right now mustr answers at that temporary …workers.dev address. Let's put it on your domain.

  1. In the Cloudflare dashboard, open Workers & Pages → your new mustr worker → Settings → Domains & Routes.
  2. Click Add → Custom Domain, type your domain (e.g. yourclan.gg), and confirm. Cloudflare sorts out the DNS and the security certificate for you. It already runs your domain from Step 2.

Give it a minute, then open your domain in a browser. You should see mustr's setup wizard waiting. On to the fun part.

6

Turn it on: the setup wizard

Where it all comes together, and mustr does the hand-holding from here.

  1. Visit your domain. You'll get a "Let's set up mustr" screen.
  2. Unlock: paste the SETUP_TOKEN you invented in Step 4. This proves you're the owner. (It also quietly builds your database tables the first time, nothing for you to do.)
  3. Identity & Discord: enter your site name and the five values from Step 3 (Application ID, Public Key, Client Secret, Bot Token, Server ID). The screen also shows you the redirect URL and interactions URL: that loose end from Step 3. Copy each, paste them where it tells you in the Developer Portal, then come back and hit "Check my Discord settings." Green means good.
  4. Claim ownership: click "Sign in with Discord." Because you're holding the keys, mustr makes you the top-rank owner with full control. Then the wizard locks itself forever. There's no take-backs button, so it's just you now.

That's it. You're the owner of a live mustr site.

7

Your first hour as an owner

You're in. A sane order to get your community actually using it:

  1. Invite the bot to your server. Now it has somewhere to go: Settings → Identity & Discord gives you a ready-made invite that asks for only the handful of permissions mustr actually uses (never Administrator). Got members wary of bots? Point them at the plain-English rundown of exactly what it can and can't do.
  2. Set your look: Admin → Theme & Branding. Logo, colors. Ten minutes here makes it feel like yours, not mine.
  3. Build your ranks to match how your group works: Admin → Ranks & Roles. Line them up with your Discord roles so the two-way sync has something to sync.
  4. Make your home page: Admin → Pages. Drag the blocks, write a welcome.
  5. Tell your members to sign in with Discord. If they're in your server, they're in. No new passwords for anyone.

And now, the clean break

The unusual part, and I want to be straight about it.

After this, you own it outright and I'm out of the picture. No subscription, no license server phoning home, no account with me, no support desk. Your mustr runs on your Cloudflare, with your data, under your control. If Cloudflare's free tier keeps doing what it's done for years, it keeps costing you nothing but the domain renewal.

That independence is the whole point. Nobody can rug-pull a site that only depends on your accounts. The flip side is the one from the top: when something confuses you, the answer is this guide and your own tinkering, not a ticket to me.

I built it to not need me. Go run your clan.

Quick glossary

For when a word looks scary.

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. Your roster lives in D1; images in R2. You never touch these directly.
Nameservers: the setting that says "Cloudflare is in charge of my domain."
Discord app / bot: the ID card mustr wears to talk to your server.
Client Secret / Bot Token: passwords for that ID card. Guard them.
SETUP_TOKEN: a one-time password you invent to claim ownership on day one.
Secrets / variables: labeled boxes on Cloudflare where you paste those values.

If something's stuck

Ready to run your own?

The button back in Step 4 is the whole install. No terminal, no bill. Questions along the way? The community's in Discord.

⚡ Deploy to Cloudflare

Join the Discord if you get stuck.