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.
- 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
- A Discord server you own or admin — the one mustr will be the website for.
- A Cloudflare account (free; made in Step 2 if you don't have one).
- A credit or debit card, to buy the domain name.
- 45 minutes and a cup of something.
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
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.
Make a Cloudflare account and add your domain
- Sign up for a free Cloudflare account and confirm your email.
- Find "Add a domain" and type the one you just bought.
- Cloudflare gives you two "nameservers" (like
something.ns.cloudflare.com). Copy them. - Back at your registrar, find the "Nameservers" setting and replace what's there with Cloudflare's two.
- Return to Cloudflare and let it check — this can take minutes to a few hours. It'll email you when ready.
You just told the internet "Cloudflare is in charge of my domain now." That's all nameservers do.
Create your Discord application
The fiddliest part. Go slow, and keep a notepad open — you'll paste these values back in during Step 6.
- In Discord's Developer Portal, click "New Application." Name it anything.
- On the main page, copy the Application ID (Client ID) and Public Key.
- Open "OAuth2" and copy the Client Secret (Reset Secret if none is shown). Treat it like a password.
- Open "Bot," add one if prompted, then Reset Token and copy the Bot Token. Also a password.
- Still in Bot, turn ON "Server Members Intent." mustr needs it to see who's in your server. Leave the rest off.
- 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.
Deploy mustr to Cloudflare
- Click it, sign in with your Cloudflare account, and let it connect your GitHub — it makes you your own copy of mustr.
- 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.
- Hit deploy and wait a minute. mustr is now live at a temporary address like
mustr.your-name.workers.dev.
Point your domain at mustr
- In the Cloudflare dashboard: Workers & Pages → your new mustr worker → Settings → Domains & Routes.
- 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.
Turn it on: the setup wizard
- Visit your domain — you'll get a "Let's set up mustr" screen.
- Unlock: paste the
SETUP_TOKENfrom Step 4. This proves you're the owner and quietly builds your database tables. - 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.
- Claim ownership: click "Sign in with Discord." You become the top-rank owner with full control, and the wizard locks itself for good.
Your first hour as an owner
- 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.
- Set your look: Admin → Theme & Branding.
- Build your ranks to match your group: Admin → Ranks & Roles.
- Make your home page: Admin → Pages.
- 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
If something's stuck
- My domain doesn't load mustr yet. The nameserver handoff can take a few hours; wait for Cloudflare's confirmation email.
- The wizard says my Discord settings are wrong. Re-check the five values against your notepad, and confirm you pasted the redirect/interactions URLs into the right Developer Portal fields.
- I can't sign in / it says I'm not in the server. Sign in with the Discord account that's actually a member of the server you set as the guild.
- The bot isn't responding to buttons. Confirm the interactions URL is pasted into the Developer Portal and the bot is invited.