Pick a channel on the left to start chatting.
People join this server with an invite link from its admin.
📷 Cameras
🖥️ Streams
🎶 Listening TogetherUp next: Nothing queued
0:000:00
📌 Pinned Messages
Uploading...
0:00Recording. Click the mic or Send to post it, Escape to throw it away.
ServerConnected
Ping--ms
ChannelNone
Online0
🧵Thread
Thread starter
Add a Server
Connect to a friend's Yeast server
(optional)
🌎 Time & Timezone
Set your preferred timezone and formatting here. These settings will be persisted to your account and will be used across all your devices. Your timezone is never revealed to any user.
This is how times will look
—
Edit Profile
Letters, numbers, underscores, and spaces (2–20 chars)
(max 190 chars)
Avatar
JPG, PNG, GIF (animated!), WebP · Max 2 MB
Animated images can't be edited.
Groups
Groups are displayed as roles on your profile card. They don't grant permissions, but they can grant channel access!
Edit
100%
⤢
⟳
Edits
Moderate User
Removes the user's messages (archived/protected messages are preserved)
Replaces the user's messages with placeholder text instead of deleting them. Default: "User banned."
Bans up to the 5 most recently seen IPs for this user. Warning: an IP ban may affect other users on the same network (CGNAT, VPN, school/work). Requires the "ban_ip" permission.
⚙️ Settings
🗣️ Localization
Changes apply immediately
🌎 Timezone
Using this device's timezone
Saved to your account and used on every device
📐 Layout
🎨 Theme
📏 Layout Density
📜 Channel Scrolling
✉️ Message Box
Enter still sends. Frees the end of the message box if you never click the button.
Upload, emoji, GIF and the rest sit behind a single + at the start of the message box, so the box gets the room.
🔍 Zoom
Scales the whole interface. Drag for the exact size you want.
🎨 Role Display
How role colors are shown next to usernames in chat and the member list.
🖼️ Image Display
🖼️ Image Display Mode
✨ Animated Profile Pictures
Applies to everyone's avatars and borders as you see them. Anyone who has turned animation off for their own profile stays still regardless.
🎞️ Animated Images in Chat
Applies to GIFs and other animated images posted in messages, for you only. Nobody else's view changes.
🔗 Link Previews
💬 Chat
Press the Up arrow key on an empty input to quickly edit your last message.
Hovering over a name or avatar shows a quick profile preview. Clicking opens the full card either way.
🔔 Sounds
General message sounds (off by default). @Mentions, replies, and DMs always notify.
Suppress all notifications, sounds, and taskbar badge from this server.
Pings for roles you hold, like @Moderators. Off means they count as ordinary messages.
Throttle how often desktop/browser notification pop-ups appear, so a burst of messages or a flaky connection can't keep popping the app up. Notification sounds and unread badges are unaffected. Never also turns off push notifications on this device.
Automatically open screen shares when someone starts streaming. Turn off to join manually.
Hide the voice users panel on desktop. Voice users are still shown in channel indicators.
Show mute/deafen buttons in the sidebar instead of the voice panel header.
Play short cue tones when muting, unmuting, deafening, or using push-to-talk in Yeast Desktop.
Browse sounds, assign to events, set hotkeys
📲 Push Notifications
Checking...
Receive notifications even when Yeast is closed
🎮 Activity
Others can see what you're playing or listening to. Games and music only appear once you link an account below. Nothing is ever shared while your status is Invisible.
🔞 NSFW
Channels an admin marked 🔞 leave your sidebar until you turn this off. Handy on a phone in public.
The picture and preview of a topic marked 🔞 sit behind a blur, like a spoiler. Turn this off to see them plainly.
🔒 Password
🗝️ Encryption Passphrase
Your encrypted DMs use a key that is backed up on the server, so your other devices can use it too. Normally that backup is locked with your login password, which the server receives every time you sign in. Lock it with a separate passphrase instead and the server can never open it. You type the passphrase once on each new device, and nobody can reset it for you, including the server admin.
🤖 Agents
Agents are accounts for your Hermes assistants. They show under your name, answer only you, and talk only in the channels you share them into, never in direct messages.
Copy this password into the agent's .env now. It will not be shown again.
💻 Active Sessions
Devices with Yeast open right now. A device that is signed in but closed will not be listed, so sign out everywhere if you think someone else has your account.
🔐 Two-Factor Authentication
Protect your account with a TOTP authenticator app (Google Authenticator, Authy, etc.).
Scan this QR code with your authenticator app:
Or enter this secret manually:
🗝️ Backup Codes
Save these codes somewhere safe. Each can be used once if you lose access to your authenticator.
✅ Two-factor authentication is enabled
🔑 Account Recovery
Generate one-time recovery codes to regain access if you forget your password. Store them somewhere safe — they work like a last-resort key.
⚠️ Important: Using a recovery code to reset your password will permanently and irreversibly destroy your end-to-end encryption keys. All encrypted direct message history will become unreadable. There is no way to undo this.
Save these codes now — they will not be shown again. Each code can only be used once.
⚠️ Delete Account
Permanently delete your account. This cannot be undone.
🧹 Delete All My Messages
Remove every message and file you ever posted here, in one go, and keep your account. Messages a moderator has protected stay. This cannot be undone.
Extension Safe Mode
Custom themes and plugins are suppressed for this session. You can reset them or exit without changing your saved choices.
⌨️ Desktop Shortcuts
Global keyboard shortcuts — active even when Yeast is in the background. Click a row to rebind, or "Clear" to disable.
Mute / Unmute—
Deafen / Undeafen—
Push-to-TalkNot set
Lone modifiers (Alt / Ctrl / Shift) and extra mouse buttons (Mouse4 / Mouse5) can be bound here. Some bindings require a recent Yeast Desktop build to register at the OS level.
🖥️ Desktop App
Settings specific to Yeast Desktop.
Launch Yeast Desktop automatically when you log in to your computer.
When launching on login, start minimized to the system tray instead of showing the window.
Closing the window hides Yeast to the system tray instead of quitting.
Hide the File / Edit / View / Window / Help toolbar. Press Alt to temporarily show it.
🧰 Advanced
🐞 Debug
Experimental client-side toggles. These don't change anything on the server.
Highlight your own avatar the moment your mic crosses the talk threshold, instead of waiting for the server to echo it back. Default off — the server echo is usually preferred because it confirms your audio actually reached the server.
Force the mic to start muted every time you join a voice channel. Useful if you tend to lurk first, or if you don't want to risk hot-mic'ing right after joining. You can unmute normally once you're in.
Join voice channels without requesting microphone access. You'll hear everyone but won't be able to talk. Useful if you don't own a mic, can't grant mic permission right now, or just want to listen in. Yeast will also fall back to listener-only automatically if the mic can't be opened for any reason.
Re-enable echo cancellation, noise suppression, and auto gain control on the audio captured from your screen share. Default off as of 3.17.3 because these filters mangle music and game audio. Turn this on if you're sharing voice content (tutorial narration, a podcast, a meeting) where the cleanup actually helps. Does not affect your microphone, which always gets full voice processing.
By default Yeast plays incoming screen-share audio straight through the audio element, which keeps it in sync with the video over a TURN/relay connection. Turn this on to route it through Yeast's Web Audio mixer instead, which unlocks the per-stream volume boost above 100% but can cause audio stutter and audio/video desync over a relay (it's fine on a local network). Leave it off if a screen share's audio stutters or drifts out of sync.
Turn this on if your screen share stutters and drifts out of sync for viewers, but only when the call goes through a TURN server and never on your local network. It lowers the video bitrate back to the pre-3.18.1 values and lets the encoder drop frames when the connection is struggling, instead of holding the framerate and letting the backlog grow. Picture quality will be lower. Only the person sharing needs it on.
On by default. When a viewer can only be reached through a TURN relay, your share to that one viewer uses the gentler profile above, while viewers on a direct connection keep the full-quality one. Turn this off if you would rather the toggle above be the only thing that decides.
If you sometimes rejoin a voice call and still can't hear one or more people until you leave and rejoin, turn this on. When two people reconnect at the same moment their connections can collide mid-repair and one direction of audio stays dead; this makes Yeast re-run the repair so the audio comes back on its own. Off by default while it's still being tested.
Fix washed-out or over-saturated colors on HDR monitors. Requires restart.
Workaround for Nvidia G-Sync / VRR monitors where Yeast Desktop drops to ~5 FPS after the window is minimized or hidden behind another window. Tells Chromium not to wait for the monitor's vsync signal before drawing frames. May cause visible tearing on monitors without variable refresh rate. Requires restart to take effect.
Pairs with the GPU vsync toggle above. Removes Chromium's internal frame-rate limit, which on some Nvidia G-Sync setups gets stuck at a very low value and never recovers. Only useful if the vsync toggle alone didn't help. Can increase CPU/GPU usage. Requires restart to take effect.
Linux only. Lets Yeast Desktop use your graphics card's VA-API video encoder for screen sharing even where Chromium's driver blocklist would not, including on Nvidia cards. It can lower CPU use while you share, but some drivers give black or broken video, so it is off by default. Requires restart to take effect.
Linux only. Runs Yeast Desktop through X11 (XWayland) instead of native Wayland. Try it if the window flickers, which some Nvidia cards do on Wayland. In this mode screen sharing may only list some windows. Requires restart to take effect.
🏠 Server Branding
Custom title displayed on the login screen below the YEAST logo.
Server icon (square, max 2 MB)
⬡
Server banner (wide, max 4 MB)
No banner
Appearance & Welcome
New users see this theme on first visit. They can still pick their own.
New users see Yeast in this language on first visit. They can still pick their own.
Shown when a new user joins a channel. Use {user} for the username. Leave blank to disable.
🟢 Presence & Activity
Turn this off to keep users Online until they change their status themselves.
Time without input before an active tab changes the status to Away.
Time without input before a hidden tab changes the status to Away.
⚖️ Custom Terms of Service
Add custom terms that appear before the default ToS on the login page. Supports plain text. Leave empty to show only the default Yeast ToS.
👥 Members
Puts a Delete All My Messages button in everyone's Settings, next to Delete Account, for people who want to leave nothing behind. It works whether or not their role may delete messages one by one; messages a moderator has protected are kept.
Channels with screen share or music turned off show small crossed-out icons next to their name. Turn this on to hide those icons for everyone.
⚠️ When enabled, admins can reset any user's password to a one-time temp value. The user must change it on next login. Resetting a password also wipes that user's E2E DM history (their wrap key derives from the password). The fact that this is enabled is exposed via /api/public-config so users can see whether admins on this server have this power.
👑 Role Management
Create and manage roles. Assign roles to users from the user list context menu.
Role Icon Visibility
Controls where role icons appear. "After username" moves icons to the right side of the name instead of the left.
Channel Creator Role
When a non-admin who can create channels makes one, they are given this role inside that channel so they can manage it. Admins are never affected.
🔒 Security
🔑 Single sign-on (OIDC)
Let members sign in with an account from your own identity provider (Authentik, Keycloak, Authelia, Auth0 and anything else that speaks OpenID Connect) instead of a Yeast password. Fill in the issuer address and client ID here, then put the client secret in your .env file as OIDC_CLIENT_SECRET and restart. The secret is deliberately kept out of the database so your backups never carry it. Register this address with your provider as the redirect URI: https://your-yeast-address/api/auth/oidc/callback
Encrypted DMs are unlocked by a key derived from what you type when you sign in, and an SSO member never types a password here. They are asked to set a separate encryption passphrase on their first sign-in, and for it again on each new device. Nobody, including you, can reset that passphrase for them.
Off means only people who already have a Yeast account linked to your provider can sign in this way. Since linking an existing account is not built yet, leaving this off will turn away everyone new.
OIDC_CLIENT_SECRET is not set in the server environment, so the sign-in button stays hidden until it is.
🔗 Referrer configuration
Sets the Referrer-Policy header Yeast sends to browsers, which controls how much of the current page's address is shared when the browser loads resources or follows links to other sites. The recommended options cover almost every server; the advanced policies are standard browser values left to your discretion. Policies that would send the full page address to other sites are not offered, because Yeast invite links live in that address.
Same-Origin (default): within this server, shares the full address; to other sites, shares nothing.
No-Referrer: shares nothing anywhere — not even within this server.
Strict-Origin-When-Cross-Origin: within this server, shares the full address; to other sites, shares only the origin. This was Yeast's default before 3.41.0 — pick it to go back to the old behaviour.
Same-Origin and No-Referrer send nothing to other sites, so either one fixes embeds whose CDN rejects a cross-origin referrer, such as Twitter/X video. If an image or embed somewhere else stops loading after this change, that host wants a referrer: switch to Strict-Origin-When-Cross-Origin to restore the pre-3.41.0 behaviour.
🎙️ Voice privacy
Yeast voice is peer-to-peer, so by default everyone in a call can see everyone else's IP address. It is how the connection is made, it needs no clicking, and nobody is told it happened. Relay-only mode routes all voice through your TURN server instead, so participants only ever see the TURN server's address. This needs a TURN server configured under Voice & Connectivity, and it uses your server's bandwidth for every call.
🔔 FCM Privacy
FCM (Firebase Cloud Messaging) is Google's system for delivering push notifications to Android phones. It's what wakes your phone when you receive a new message while Yeast is closed. This means that all notifications (including your Yeast username, channel name and message content) sent to your Android phone have to pass through Google's servers to reach your phone.
While this may be fine for most users, some may prefer to keep Google completely out of the equation. UnifiedPush is a decentralized notification standard that supports several notification apps, and if a UnifiedPush compatible app is installed on your phone, Yeast Mobile will prioritize it over FCM.
Dangerous Action Warning: Before disabling this, please ensure every member in your Yeast server including yourself has a UnifiedPush compatible app installed on their phone. Otherwise, some members of your server will not receive any mobile notifications.
🛡️ Auto-Mod
Checks the links in messages, edits, DMs, profiles and channel topics against a domain policy you control. Blocked content is rejected before it is saved, so it never reaches anyone else. This matters more than it sounds: Yeast renders linked images and link previews directly from the other site, so a hostile link exposes the IP address of everyone who scrolls past it, not just whoever clicks.
Allowlist is the strict option and the one that stops links you have never seen before. Blocklist only stops domains you already know about.
🌐 Domains
🔤 Words
Groups of words that block a message, each worth a number of strikes towards the escalation below. Whole words only, case does not matter, one word or phrase per line. Staff at or above the skip level are not checked.
⚙️ Rules
0 disables this. Applies even to allowed domains, and is the single most effective rule against register-post-link-get-banned-repeat.
Members at or above this level are never filtered. Admins are always exempt.
Direct messages are end-to-end encrypted, so the server genuinely cannot read them and cannot block a DM as it is sent. Instead the check runs in the recipient's app after it decrypts: a link to a domain you have not allowed is shown as plain text with a warning rather than something clickable, and images from those domains are not loaded. Senders are warned before the message goes out. This relies on the recipient running an app that implements it, so treat it as a strong deterrent rather than a guarantee.
Strongly recommended. Link previews load images straight from the other site in every viewer's browser, which hands that site everyone's IP address without a single click.
⚖️ Escalation
Counts blocked attempts within a rolling window. Set any threshold to 0 to disable that step. Note that a muted member cannot send anything at all, so they stop collecting strikes until the mute runs out — if you want a fast automatic ban, set the ban threshold close to the mute threshold, or turn muting off.
⚠️ Leave off unless you understand the risk. Shared and mobile-carrier addresses mean an IP ban can catch people who did nothing.
📊 Recent activity
🚪 Who can sign up
Adds a Cloudflare Turnstile challenge to the sign-up form to block automated mass registration. It's free: create a widget at the Cloudflare Turnstile dashboard and paste both keys below. Leave off if you don't need it.
Caps how many new accounts can be created across the whole server each hour, to slow a bot flood even when it comes from many different addresses. Sign-ups above the cap are asked to try again later, so set it comfortably above your normal rate.
🔗 Invite links
People join this server with an invite link. A link can expire after a set time or last until you revoke it.
Anyone with this server's address can join, without an invite link.
😎 Custom Emojis
Upload images for custom server emojis
🔄 Built-in emoji updates
Allow Yeast to check Unicode.org for new emoji standards. This check is only performed at server boot, and only when the current standard file on disk was created over a month ago. If a new standard is available, Yeast will automatically download the emoji pack and regenerate all your built-in emojis based on the new standard. This does not affect your custom emojis in any way.
When this setting is turned off, Yeast will use the latest available standard on disk. If a standard was never downloaded before, Yeast will default to Unicode standard 16.0 which is bundled with the server.
PS: This feature has nothing to do with emoji styling. That is entirely dependent on your OS, and rendering will vary from machine to machine. This feature only guarantees you'll have the latest available emojis built into your Yeast server.
🖼️ Stickers
Upload sticker images grouped into packs
🔊 Custom Sounds
Upload audio files for custom notification sounds
📁 Uploads & Limits
Maximum file size users can upload in MB (default 25). No hard cap — limited by your server's available disk space.
How many files someone can queue on one message by dropping, pasting or picking them (1 to 50, default 10). Each one still has to fit the size limit above.
Maximum characters per message, post, or DM (200–100000, default 2000)
Max soundboard upload size (256–10240 KB, default 1024 / 1 MB)
Max custom emoji upload size (64–1024 KB, default 256)
Max sticker upload size (256–10240 KB, default 1024 / 1 MB). Bump this up to allow larger GIF-style stickers.
Maximum answer choices per poll (2–25, default 10)
How long a login token stays valid before users must sign in again. "Never expire" keeps users logged in until they hit Logout or change their password. Applies to new logins only; existing tokens keep their original expiry until they expire or rotate.
🤖 Webhooks / Bots
Create and manage webhook bots that can post messages to channels.
No bots configured
📦 Discord Import
Import channels and messages from a Discord export file
🧩 Server Template
Save this server's layout as a file others can use to set up theirs the same way, or set this server up from someone else's template.
Export
Includes the name and branding, categories, channels and their settings, roles and permissions, self-assign role menus, webhook slots and link rules. Never includes members, messages, DMs, encryption keys, invite codes, webhook tokens, passwords or API keys.
Import
Nothing is deleted in either mode: channels and roles that are not in the template stay as they are.
🗑️ Deleted files
Attachments from deleted messages and channels are held this long, then removed for good. This runs whether or not auto-cleanup is enabled (default 7).
📜 Audit Log
Track admin and moderator actions: channel changes, role updates, bans, kicks, server settings, and more.
🧰 Advanced
Tools for running the server itself. Most servers never need these.
⬆️ Server Updates
Check for new Yeast releases and apply them in place. The server will create a pre-update backup automatically and restart itself.
📡 Voice & Connectivity
STUN/TURN servers let voice and screen share connect between users on different networks. Leave blank to use Yeast's built-in STUN pool. If users outside your local network get stuck on "ICE: Connecting...", set your own servers here.
Use this for LAN-only servers. Voice and screen sharing will use direct local network connections; users on different networks may not connect.
One stun: URI per line (or comma separated). Blank = built-in defaults.
A TURN server relays traffic for users behind strict NATs that STUN alone can't connect. Only needed if some users still can't connect after setting STUN. Username/password apply to static-credential TURN servers.
Checks the servers above the same way a call does, and says in plain English what works and what doesn't. Save your changes first.
🏟️ Large Server Setup
What a big community needs, in one place. A server for friends and family can skip this page.
🔊 Voice relay
Normally everyone in a call sends their voice and video straight to everyone else. That works for a handful of people, but past about ten each person's upload runs out. With a relay, each person sends once, to this server, and the server passes it on, so calls can hold many more people. It uses this server's internet connection instead of theirs. One thing changes: direct calls go person to person, but relayed calls pass through this server, so whoever runs it could in principle listen in, as with any voice server.
Where people connect to reach the relay: this server's public IP address or domain name. Leave it empty and Yeast works it out when the relay starts. Everyone in a relayed call can see this address (and, so people on your own network connect directly, the server's local address), as with any voice server; a server hidden behind a proxy is not hidden from them.
One core carries many calls. Add more when calls get very large or numerous; each extra core uses the next port up.
The relay is not installed on this server yet. Installing it downloads about 10 MB, once; Yeast updates keep it. It works on Windows, Linux (including Raspberry Pi and Docker) and Apple Silicon Macs.
Takes effect straight away. Calls in progress reconnect by themselves.
✅ Also worth setting for a big server
Member list
Show online members only, so a server with thousands of accounts does not list every one of them.
Sign-ups
A captcha and a limit on new accounts per hour stop floods of spam accounts.
Auto-moderation
Block links from brand-new accounts and step up to bans automatically when moderators cannot watch every channel.
Guest access
Decide whether people can drop in without an account, and whether guests may use voice.
Limits
Message length, upload size and attachments per message keep storage and bandwidth in check.
Backups and cleanup
Automatic backups, and clearing out old files so the disk does not fill up.
TURN server
Lets people on very strict networks (some offices, schools, mobile carriers) connect to voice at all.
🧭 Tunnel
Inactive
💾 Server Backup
Download a backup of this server, or restore from a previous backup. Useful when you don't have shell access to the host machine.
Download Backup
Pick what to include. Messages and uploaded files can make the backup very large; channels, users and settings alone are usually small. To restore or move a server, tick Messages: that carries the whole database, so everyone keeps their account and password. It also means the file holds everyone's login details (passwords stored scrambled, never readable), 2FA secrets and emails, so keep it somewhere safe.
Restore From Backup
Uploading…
Only full backups can be restored here, which means the backup must have had both Messages and Uploaded files checked when it was made. Smaller channels/users/settings backups have to be re-imported by hand.
Warning: Restoring overwrites the current server data. The server will restart automatically — your hosting setup must support auto-restart (Docker, systemd, the Yeast installer service, etc.). The previous database is preserved as haven.db.pre-restore for one cycle.
Automatic Backups
Include in scheduled backups:
Auto-backups are saved to the server's data directory and pruned to your retention count. They use the same format as manual downloads, so you can restore any of them above.
🖼️ Image privacy
Yeast fetches images from other sites itself and serves them from its own cache, so your members' browsers never contact those sites. With this off, anyone who posts an image link collects the IP address and browser details of everyone who scrolls past it, without a single click. It also means embeds keep working after the original link expires or the site goes down. Costs some bandwidth and disk on your server; each image is fetched once and cached for 30 days.
🚫 Banned IPs
🔑 Member accounts
Reset someone's password or delete their account.
Changes only apply when you click Save. Close (✕) to cancel.
📦 Import from Discord
Upload a Discord export file to import channels and messages into Yeast.
DiscordChatExporter— JSON or ZIP (recommended — includes all users)
Discord Data Package— ZIP from Settings → Privacy (your messages only)
📁Drop file here or browse.json or .zip — up to 500 MB
Uploading...
Pull a Discord server's history straight into Yeast.
🛶 Use your Ferry bot (recommended)
Your Ferry bot reads the history for you. Nothing to paste, and it's within Discord's rules. It can import every channel it can see on Discord.
Ferry isn't set up on this server yet. It takes about two minutes, and you only do it once.Set up Ferry
Or use your personal Discord login (not recommended)
⚠️ Read this first
This uses your personal Discord login token. Discord's rules don't allow apps to use a personal account this way, so Discord could lock or ban the account you use.
Anyone who gets your token can take over your Discord account. Only paste it into a Yeast server you run yourself, and never because someone asked you to.
Your Ferry bot, above, does the same import within Discord's rules.
How do I get my Discord token?
Open discord.com/app in Chrome/Edge (or use the desktop app)
Press F12 to open DevTools
Click the Application tab (click >> in the toolbar if you don't see it)
In the left sidebar, expand Local Storage → click https://discord.com
Find the token key — copy the value (without the quotes)
Desktop app: If F12 doesn't open DevTools, close Discord fully, then edit:
New servers start with Member, Mod, and Admin (you). Members can use every public channel. Mods can kick, ban, and run channels. Admin can do everything.
👑 Role Management
Select a role to edit
👥
Server-wide assignment only. For channel-specific roles, use the Role Assignment menu in member management.
👑 Assign Role
A user may hold multiple roles. Their effective permissions are the union of every role they hold, and their displayed badge color comes from the highest role.
Server-wide applies to all channels. Channel-specific only applies within that channel.
👑 Role Assignment
Select a user, then a channel, then configure their role.
Users
Channels
← Select a user
Role Configuration
← Select a channel
🤖 Bot Management
Select a bot to edit, or create a new one
🔊 Sound Manager
Browse & play custom sounds. Set hotkeys to play them anytime.