Nothing matches that. Ask us and we'll add a guide.
Getting started
Make an account
- Open Grumble in your browser or the app, and choose Create one.
- Pick a username and a password, and say which age group you're in.
- Write down your 12 recovery words when Grumble shows them. They're the only way back into your account and your encrypted DMs if you forget your password.
No email address, phone number or ID is needed, except in Australia, where the law requires an email address at sign-up.
Get the app
- Go to Downloads.
- Pick Windows, Linux or Android, or keep using Grumble in your browser.
- Log in with the same username and password.
The Windows app and the Linux AppImage update themselves. When an update is ready, a button appears in the title bar. The Android app from our site offers each new version itself. Tap Update to install it.
Find your way around
- The column on the far left is your servers. The pug at the top is your DMs and friends.
- + adds a server, and the compass opens Discover.
- Your name and picture are at the bottom left, with your microphone, sound and Settings.
Add a friend
- Open your DMs (the pug at the top left), then Friends.
- Choose Add friend and type their username.
- They see your request under Pending and accept it there.
Servers
Create a server
- Choose + at the bottom of your server list.
- Give it a name and pick where to start: just #general, or a starting set of channels for gaming, friends, a study group, a school club, a local community or artists.
- Choose Create.
You can also start from someone's server template link, or bring a server over from Discord with Import from Discord.
Invite people
- Next to a channel's name, choose the invite icon (a person with a plus).
- Copy the link and send it to whoever you like.
Server Settings, Invites lists every link and lets you revoke one.
Find a public server in Discover
- Choose the compass at the bottom of your server list.
- Search, or pick a category.
- Choose a server to see more, then Join server.
Everyone sees the same list, biggest first. Nothing about you is used to sort it, and searches aren't kept. Age-restricted servers are never listed.
List your server in Discover
- Open Server Settings, then Discovery.
- Check the list of what's needed: a description, a rules channel, verification level Low or higher, not age-restricted, at least 5 members and a week old. You can fix some of them right there.
- Pick a category and add a few search words.
- Turn on List this server in Discover.
Set up roles and permissions
- Open Server Settings, then Roles.
- Make a role, give it a name and colour, and pick what it may do.
- Give the role to people from their profile or from Members.
A channel can change what a role may do there, in that channel's settings under permissions.
Share your server as a template
- Open Server Settings, then Server template.
- Give the template a name and choose Make template.
- Copy the link. Anyone who opens it can start a server with the same channels, roles and settings.
A template never includes messages, members or emoji. It does show its channel and role names to whoever opens the link.
Put a widget on your website
- Open Server Settings, then Widget.
- Turn it on and pick the channel the Join button invites to.
- Copy the code shown and paste it into your website.
The widget shows your server's name, picture, how many people are online and a Join button. It never shows who's in the server.
Messages
Reply, react, edit or delete
- Hover over a message (or long-press it on a phone).
- Choose an emoji to react, the arrow to reply, or … for more, including edit and delete for your own messages.
On a phone you can also swipe a message to the left to reply.
Send photos and files
- Choose + in the message box, or drag files onto the chat.
- On a phone, pick several photos at once from the gallery that opens.
Search messages
- Use the search box at the top of a channel.
In encrypted servers and DMs, search happens on your device, because the server can't read the messages.
Voice and video
Join a voice channel
- Choose a voice channel in a server's channel list.
- Use the buttons at the bottom to mute, deafen, turn on your camera or share your screen.
- Choose the red button to leave.
Share your screen
- In a call, choose Share screen.
- Pick a window or your whole screen.
Calls are end-to-end encrypted: only the people in the call can see and hear them.
Set up your microphone and camera
- Open Settings, then Sound and video.
- Pick your microphone, speakers and camera, and try them out.
- Turn on noise suppression or a camera background if you like.
Play an activity together in a call
- In a call, choose … (more) and then Start an activity.
- Pick one. The first time, Grumble tells you which site it runs from and asks before opening it.
- Everyone else in the call sees it with a Join button.
Activities are made by people outside Grumble and run from their own sites, which see your internet address. Grumble's server never learns which activity your call is running.
Stream with OBS
- Get Grumble for OBS.
- In a call, choose Stream to OBS and follow the steps.
Someone only appears on your stream if they've said you may put them on it.
Privacy and safety
Keep your encrypted DMs
- Write down your 12 recovery words when Grumble shows them, and keep them somewhere safe.
- Logging in on a new device brings your DMs along, because your keys are kept locked with your password.
If you forget your password, the 12 words are the only way back in. Nobody can reset it for you, not even Grumble. Settings, Encrypted DMs shows them again.
Report a message, person or server
- Right-click it (or long-press on a phone) and choose Report.
- Pick what the problem is and add a note if you like.
- Follow what happens in Settings, Safety Centre.
The person you report never learns who reported them. You can also report a server or an app from Discover.
Block someone
- Right-click their name and choose Block.
They can't message you or send you friend requests. Friends, Blocked lists everyone you've blocked.
See what Grumble keeps about you
- Open Settings, then Your data.
- It lists everything we keep, exactly, and when each piece goes.
- You can download a copy of your data there too.
Take back a website's access
- Open Settings, then Authorised apps.
- Choose Remove next to the website.
Websites you sign in to with Grumble only see what you agreed to, never your email address or age, and their access stops at once when you remove it.
Your account
Change your name or picture
- Open Settings, then Profile.
- Change your display name, picture, banner, pronouns or bio.
Turn on two-factor authentication
- Open Settings, then Account.
- Choose to turn on two-factor and scan the code with an authenticator app.
Change your notifications
- Open Settings, then Notifications.
- For one server, right-click it and pick its notification settings.
Delete your account
- Open Settings, then Account.
- Choose Delete account and confirm.
If you own servers, hand them to someone else or delete them first.
Bots and apps
Add a bot to your server
- Find it under Discover, Apps, or open the link its maker gives you.
- Choose Add to server, pick a server you manage and check what it asks to do.
Make your own bot
- Open the Developer Portal at developers.grumble.gg.
- Create an application, add a bot and copy its token.
- Read the developer docs to get it running. Libraries made for Discord work.
Show your game in your profile
- Turn on sharing what you play in Settings, What you share.
- Games with Rich Presence show what's happening in them through the desktop app.
Grumble finds many games on its own. Add one it misses in Your games.
When something's wrong
Nobody can hear me
- Check you're not muted (the microphone at the bottom left).
- Open Settings, Sound and video, and check the right microphone is picked.
- Allow Grumble to use your microphone if your browser or phone asks.
Phone notifications don't arrive
- Check notifications are allowed for Grumble in your phone's settings.
- On some phones, let Grumble run in the background (battery settings).
- Check the server or DM isn't muted.
It says Reconnecting
- Wait a few seconds: Grumble picks the connection up again on its own.
- If it carries on, check your internet connection, then reopen the app.
I forgot my password
- Choose Forgot your password? on the log-in screen.
- Enter your 12 recovery words and pick a new password.
Without the 12 words, a forgotten password can't be reset, because Grumble never had it.