Note

• When ANALYZE is set to true, the client will generate a bundle analysis report. This is useful for debugging and optimizing the client bundle.
• Refer to the Cloudflare Turnstile documentation to get your Turnstile site key.
• The CLIENT_SECRET value is attached to the requests sent by the client's server-side rendering. You can use any random string for this value. This value is used for verifying the requests sent by the client's server-side rendering and should match the server's CLIENT_SECRET value.
• The NEXT_PUBLIC_CDN_URL is used for serving emojis and sounds files. You should set this to your own CDN URL. Make sure to use valid URL format (e.g., https://cdn.yourdomain.com).

Note

• The GITHUB_AUTO_SYNC_TRANSLATORS_SECRET is used for syncing the translators roles when a push is made to the main branch. When this secret is set and you have set up the GitHub webhook, the server will automatically sync the translators roles in the base guild with the ids in the client/locales/translators.json file.
• You should use 256-bit secret keys for the BOT_API_KEY_ENCRYPT_SECRET, USER_TOKEN_ENCRYPT_SECRET and PAYMENTS_CUSTOM_DATA_ENCRYPT_SECRET_KEY values. You can use this tool to generate a 256-bit key in hexadecimal format quickly.
• The CLIENT_SECRET value is attached to the requests sent by the client's server-side rendering. You can use any random string for this value. This value is used for verifying the requests sent by the client's server-side rendering and should match the client's CLIENT_SECRET value.
• The DISCORD_PORTAL_CHANNEL_WEBHOOK_URL is used for sending messages to the portal channel. This is not required for self-hosting. We use this webhook for sending messages to the portal channel for certain events like new bot approved, new emoji published, etc. This webhook should be created by bot. Otherwise, no components (link buttons) will be sent with the messages. You can leave this value empty. Make sure to use a valid Discord webhook URL format (e.g., https://discord.com/api/webhooks/XXX/XXX).
• For the MONGO_URL value, you can use a local MongoDB instance or a cloud-based MongoDB service like MongoDB Atlas. Refer to the MongoDB documentation for more information on constructing the connection URL.
• Values starting with S3_ are required. This is used for storing emojis & sounds files in S3 (and also database backups). We personally use Cloudflare R2 Storage for this. You can use any S3-compatible storage service with the same configuration. Note: You can leave the S3_DATABASE_BACKUP_* values empty if you don't want to use S3 for database backups. We use S3 for storing the database backups, but this is not required for self-hosting. If you leave these values empty, the server will not take any database backups and throws warnings in the console when you start the server.
• The CDN_URL is used for serving emojis and sounds files. You should set this to your own CDN URL. Make sure to use valid URL format (e.g., https://cdn.yourdomain.com).
• The CLOUDFLARE_TURNSTILE_SECRET_KEY is used for verifying the Turnstile token. We use Cloudflare Turnstile for ensuring that the user is a human and not a bot on the website. Refer to the Cloudflare Turnstile documentation to get your Turnstile secret key.
• The LEMON_SQUEEZY_WEBHOOK_SECRET is used for verifying the Lemon Squeezy webhook. This is not required for self-hosting. We use Lemon Squeezy for our payment system. Refer to the Lemon Squeezy documentation for more information.
• The LEMON_SQUEEZY_API_KEY is used for authenticating requests to the Lemon Squeezy API. This is not required for self-hosting. We use Lemon Squeezy for our payment system. Refer to the Lemon Squeezy Developer Guide to get your API key.
• Values starting with HEARTBEAT_ID_ are used for the heartbeat IDs for the heartbeats. We use Better Stack Uptime for monitoring the uptime of the website.
• The DISCORD_BOT_GET_APPROXIMATE_GUILD_COUNT_API_URL and DISCORD_BOT_GET_APPROXIMATE_GUILD_COUNT_API_SECRET values are used for getting the approximate guild count of a bot. This is half required for self-hosting. If you don't want to use this feature, you can leave these values empty, but this will result in bots not being able to update server_count using the API. For now, we use private API for this because Discord doesn't provide an official API for getting the approximate guild count of a bot. We don't want to share this API source code with everyone.
• The WEBHOOKS_PROXY_SERVER_PROTOCOL, WEBHOOKS_PROXY_SERVER_HOST, WEBHOOKS_PROXY_SERVER_PORT, WEBHOOKS_PROXY_SERVER_USERNAME, and WEBHOOKS_PROXY_SERVER_PASSWORD values are used for the proxy server settings. We use a proxy server for sending webhooks requests. If you don't want to use a proxy server, you can leave these values empty. Username and password are not required for the proxy server.
• The SENTRY_DSN value is used for Sentry error tracking. This is not required for self-hosting. We use Sentry for error tracking. Refer to the Sentry documentation for more information.

Note

• The availableLocales value is used for the available locales for the website. You can change these values to your own available locales. Locale files should be in the client/locales directory with the format en.json, tr.json, etc. You can add new locale files to this directory and add the locale key to the availableLocales value. To find more details about the adding new languages to the website, check the New Languages section.
• The supportInviteUrl and docsUrl values are used in the website for the support server and documentation links. You can change these values to your own support server and documentation links.
• The api.url value is used for making API requests from the client to the server. You should change this value to your own API URL. Make sure to use domain names instead of IP addresses for the API URL. Also you should use Cloudflare for both client and server domains.
• The analytics.script and analytics.siteId values are used for setting up analytics on the website. We use Rybbit Analytics for analytics. Any other analytics service is not supported.
• The botTestGuildId value is used for when you want to quickly invite newly added bots to your test guild for testing. You can change this value to your own test guild ID.
• The botInviteURL value is used for the bot invite link. You can change this value to your own bot invite link.
• The customHostnames value is used for the custom hostnames for the profiles. You should change this value to your own custom hostnames. You should connect these hostnames to the same server where you host the website with different ports and use a reverse proxy to redirect the requests to the correct port.

Note

• The discordScopes value is used for the Discord OAuth scopes required for the website. You can change these values to your own required scopes. Usually, the identify, email, and guilds scopes are required.
• The botPresenceStatus value is used for the presence status of the bot. You can change this value to your own presence status.
• The rateLimitWhitelist value is used for whitelisted user IDs for bypassing rate limits. You can change these values to your own whitelisted user IDs.
• The trustProxy value is used for the trust proxy setting for the server. You can change this value to your own trust proxy setting.
• The frontendUrl, backendUrl, and cdnUrl values are used for the client website URL, server API URL, and CDN URL for the website. You can change these values to your own URLs.
• The supportInviteUrl value is used for the support server invite URL. You can change this value to your own support server invite URL.
• The emojis value is used for the emojis used in the bot. You should change these values to your own emojis.
• The port.frontend and port.backend values are used for the client and server ports. You can change these values to your own ports.
• The guildId and guildInviteUrl values are used for the base guild ID and invite URL for the base guild. You can change these values to your own guild ID and invite URL.
• The permissions value is used for the permissions for the server. If permission name has Roles in the end, that means that permission is role-based. Otherwise, that permission is user ID-based. You can change these values to your own permissions.
• The maxServerCountDifference value is used for the allowed maximum server count difference for the provided server_count and the actual server count in the bot's stats API route. When new requests come to the stats API route, we check the server count of the bot. If the difference between the provided server count and the actual server count is greater than this value, we reject the request.
• The roles value is used for the role IDs from the base guild. You can change these values to your own role IDs.
• The excludeCollectionsInBackup value is used for collections to exclude from database backups. We take daily backups of the database. If you don't want to take backups of some collections, you can add those collections to this value. Make sure to add the collection name exactly as it is in the database.
• The customHostnames value is used for the custom hostnames for the profiles. You should change this value to your own custom hostnames. You should connect these hostnames to the same server where you host the website with different ports and use a reverse proxy to redirect the requests to the correct port.
• The lemonSqueezy.variantIds value is used for the variant IDs for the Lemon Squeezy. We sell some products on Lemon Squeezy with different variants. You should create these variants on the Lemon Squeezy and get the variant IDs from there.
• Make sure to fill all fields that end with ChannelId with the correct channel IDs from the base guild.
• The availableLocales value is used for the available locales for the server. You can change these values to your own available locales. Locale files should be in the server/src/locales directory with the format en.json, tr.json, etc. You can add new locale files to this directory and add the locale key to the availableLocales value. To find more details about the adding new languages to the website, check the New Languages section.

Note

• Some languages may not be supported by Discord client.