Server Configuration

The server configuration lives in server/config.yml. This YAML file controls everything from Discord OAuth scopes and bot behaviour to channel IDs, role permissions, and available locales.

Make sure to fill all fields ending in ChannelId with real Discord channel IDs from your base guild. Leaving them as placeholders will cause the bot to fail when it tries to post to those channels.

Full config structure

The file below shows the default values shipped with discord.place:

server/config.yml

discordScopes:
  - 'identify'
  - 'email'
  - 'guilds'
botPresenceStatus: 'online'
rateLimitWhitelist:
  - '957840712404193290'
trustProxy: true
frontendUrl: 'https://discord.place'
backendUrl: 'https://api.discord.place'
docsUrl: 'https://docs.discord.place'
supportInviteUrl: 'https://invite.discord.place'
emojis:
  loading: '<a:loading:1247786499076915252>'
  checkmark: '<:yes:1226129515718381568>'
  pink_heart: '<:heart:1211809043564339290>'
  badges:
    admin: '<:white_admin:1267620006183571530>'
    moderator: '<:white_moderator:1251538987592712345>'
    premium: '<:white_premium:1251538989312249947>'
    verified: '<:white_verified:1251538990524403793>'
  empty_badge_slot: '<:empty_badge_slot:1251541500282798090>'
port:
  frontend: 3000
  backend: 3001
guildId: '1200254872059121764'
guildInviteUrl: 'https://invite.discord.place'
permissions:
  canEditProfilesRoles:
    - '1206032198562742312'
  # ... (full permissions object — see source)
maxServerCountDifference: 50
roles:
  jrModerator: '1206355082883371049'
  moderator: '1267549562957205645'
  headModerator: '1206354879321210900'
  admin: '1206032198562742312'
  premium: '1252335063123628084'
  translator: '1275014710692941896'
excludeCollectionsInBackup:
  - 'botdenies'
  - 'botvotetimeouts'
  - 'servervoteremindermetadas'
  - 'servervotereminders'
  - 'servervotetimeouts'
  - 'evaluateresults'
  - 'githubcaches'
  - 'plans'
customHostnames:
  - 'dsc.lat'
  - 'dsc.gay'
  - 'dsc.wtf'
  - 'dsc.baby'
lemonSqueezy:
  variantIds:
    tripledVotes:
      servers: '421124'
      bots: '421125'
    standedOut:
      servers: '425991'
      bots: '425992'
availableLocales:
  - name: 'English'
    code: 'en'
    flag: '🇺🇸'
    default: true
    countryCode: 'us'
  - name: 'Turkish'
    code: 'tr'
    flag: '🇹🇷'
    countryCode: 'tr'
# Channel IDs (replace all with your own)
emojiQueueChannelId: ''
soundQueueChannelId: ''
reviewQueueChannelId: ''
themeQueueChannelId: ''
reportsQueueChannelId: ''
botQueueChannelId: ''
templateQueueChannelId: ''
webLogsChannelId: ''
testWebhookLogsChannelId: ''

Options reference

General

discordScopes

string[]

required

Discord OAuth2 scopes requested during login. The default set — identify, email, and guilds — is required for the full feature set. Only remove a scope if you are certain the features that depend on it are not used.

botPresenceStatus

string

default:"online"

Presence status displayed for the Discord bot. Accepted values: online, idle, dnd, invisible.

rateLimitWhitelist

string[]

Array of Discord user IDs that are exempt from all rate limits. Add IDs for your admin accounts here.

trustProxy

boolean

default:"true"

Express trust proxy setting. Set to true when running behind a reverse proxy (e.g. nginx, Cloudflare) so that req.ip reflects the real client IP instead of the proxy’s IP.

URLs

frontendUrl

string

required

Public URL of the Next.js client (e.g. https://discord.place). Used by the server to construct redirect URLs and CORS rules.

backendUrl

string

required

Public URL of the Express API server (e.g. https://api.discord.place). Used to construct self-referential API links.

docsUrl

string

required

URL of the documentation site, linked from bot messages and API responses.

supportInviteUrl

string

required

Invite URL for your Discord support server, linked from bot messages and error pages.

Bot emojis

emojis

object

required

Custom emojis used in bot messages and embeds. Each value is a Discord emoji string in the format <:name:id> (static) or <a:name:id> (animated). Replace all values with emojis from your own guild.

Key	Description
`loading`	Animated loading spinner
`checkmark`	Success / yes indicator
`pink_heart`	Decorative heart emoji
`badges.admin`	Admin badge shown on profiles
`badges.moderator`	Moderator badge shown on profiles
`badges.premium`	Premium badge shown on profiles
`badges.verified`	Verified badge shown on profiles
`empty_badge_slot`	Placeholder shown when a badge slot is empty

Ports

port.frontend

number

default:"3000"

Port the Next.js client runs on. Should match NEXT_PUBLIC_PORT in the client’s .env.

port.backend

number

default:"3001"

Port the Express server listens on.

Base guild

guildId

string

required

Discord ID of your base guild. The bot uses this guild for role assignments, channel logging, and other administrative actions.

guildInviteUrl

string

required

Public invite URL for the base guild. Displayed in bot messages and on the website.

Permissions

permissions

object

required

Maps permission names to arrays of role IDs from the base guild. Permission names ending in Roles are role-based (checked against a user’s server roles). Permission names without a suffix are user ID-based.Replace all role IDs with those from your own guild. The following permission keys are available:

Permission key	Description
`canEditProfilesRoles`	Can edit any user’s profile
`canDeleteProfilesRoles`	Can delete any profile
`canDeleteServersRoles`	Can remove any server listing
`canDeleteEmojisRoles`	Can remove any emoji
`canDeleteBotsRoles`	Can remove any bot listing
`canDeleteReviewsRoles`	Can delete any review
`canDeleteTemplatesRoles`	Can delete any template
`canDeleteSoundsRoles`	Can delete any sound
`canDeleteThemesRoles`	Can delete any theme
`canApproveEmojisRoles`	Can approve submitted emojis
`canApproveBotsRoles`	Can approve submitted bots
`canApproveReviewsRoles`	Can approve submitted reviews
`canApproveTemplatesRoles`	Can approve submitted templates
`canApproveSoundsRoles`	Can approve submitted sounds
`canApproveThemesRoles`	Can approve submitted themes
`canEditServersRoles`	Can edit any server listing
`canEditBotsRoles`	Can edit any bot listing
`canViewQuarantinesRoles`	Can view quarantined users/guilds in the dashboard
`canCreateQuarantinesRoles`	Can add new quarantine entries
`canDeleteQuarantinesRoles`	Can remove quarantine entries
`canViewDashboardRoles`	Can access the admin dashboard
`canDeleteBotDeniesRoles`	Can delete bot denial records
`canRestoreBotDeniesRoles`	Can restore a denied bot
`canViewTimeoutsRoles`	Can view user timeouts
`canDeleteTimeoutsRoles`	Can delete timeouts
`canSyncLemonSqueezyPlans`	Can trigger Lemon Squeezy plan sync (user ID-based)
`canExecuteEval`	Can run arbitrary eval commands via bot (user ID-based)
`canExecuteFetchRoles`	Can trigger a role fetch
`canExecuteRefreshCacheRoles`	Can trigger a cache refresh
`canExecuteAddPremium`	Can grant premium to users (user ID-based)
`canVerifyProfilesRoles`	Can verify user profiles
`canDeleteLinksRoles`	Can delete profile links

Server count validation

maxServerCountDifference

number

default:"50"

Maximum allowed discrepancy between the server_count value a bot reports via the stats API and the actual count observed by the Discord bot. Requests exceeding this threshold are rejected. Increase this value if you expect bots with large, rapidly-changing server counts.

Roles

roles

object

required

Maps logical role names to Discord role IDs from the base guild. Replace each ID with the corresponding role in your own guild.

Key	Description
`jrModerator`	Junior moderator role
`moderator`	Moderator role
`headModerator`	Head moderator role
`admin`	Administrator role
`premium`	Premium subscriber role
`translator`	Community translator role

Database backups

excludeCollectionsInBackup

string[]

MongoDB collection names to exclude from daily database backups. Use exact collection names as they appear in the database. The defaults exclude ephemeral or easily-regenerated collections such as vote timeouts and evaluation results.

Custom hostnames

customHostnames

string[]

required

List of custom vanity hostnames for user profiles (e.g. dsc.lat). Must match the customHostnames list in client/config.js. Each hostname must be DNS-pointed to your server and proxied to the correct port via a reverse proxy.

Lemon Squeezy

lemonSqueezy.variantIds

object

Maps internal product identifiers to Lemon Squeezy variant IDs. If you are using Lemon Squeezy for premium features, create these products/variants in your Lemon Squeezy store and update these IDs.

Key	Description
`tripledVotes.servers`	Tripled votes product variant for servers
`tripledVotes.bots`	Tripled votes product variant for bots
`standedOut.servers`	Stand-out listing variant for servers
`standedOut.bots`	Stand-out listing variant for bots

Locales

availableLocales

object[]

required

Array of locale objects available on the server. Each object has the following fields:

Field	Type	Description
`name`	string	Human-readable language name
`code`	string	BCP 47 language code matching the JSON filename in `server/src/locales/`
`flag`	string	Flag emoji
`default`	boolean	Set to `true` on the default locale
`countryCode`	string	ISO 3166-1 alpha-2 country code

See Localization for instructions on adding new languages.

Channel IDs

All fields ending in ChannelId must be set to real channel IDs from your base guild.

Field	Description
`emojiQueueChannelId`	Channel where emoji submission queue is posted
`soundQueueChannelId`	Channel for sound submission queue
`reviewQueueChannelId`	Channel for review moderation queue
`themeQueueChannelId`	Channel for theme submission queue
`reportsQueueChannelId`	Channel where user reports are posted
`botQueueChannelId`	Channel for bot submission queue
`templateQueueChannelId`	Channel for template submission queue
`webLogsChannelId`	Channel for general web server logs
`testWebhookLogsChannelId`	Channel for test webhook event logs

Setup

Configuration Reference

Customization

Full config structure

Options reference

General

URLs

Bot emojis

Ports

Base guild

Permissions

Server count validation

Roles

Database backups

Custom hostnames

Lemon Squeezy

Locales

Channel IDs

Build docs developers (and LLMs) love

Setup

Configuration Reference

Customization

Documentation Index

​Full config structure

​Options reference

​General

​URLs

​Bot emojis

​Ports

​Base guild

​Permissions

​Server count validation

​Roles

​Database backups

​Custom hostnames

​Lemon Squeezy

​Locales

​Channel IDs

Build docs developers (and LLMs) love

Full config structure

Options reference

General

URLs

Bot emojis

Ports

Base guild

Permissions

Server count validation

Roles

Database backups

Custom hostnames

Lemon Squeezy

Locales

Channel IDs