# Documentation **URL:** https://meta.discourse.org/c/documentation/10.md?page=17 [Latest](https://meta.discourse.org/latest.md) · [Categories](https://meta.discourse.org/categories.md) · [Tags](https://meta.discourse.org/tags.md) **Page:** 18 --- ## [Adding metadata and screenshots to a Theme](https://meta.discourse.org/t/adding-metadata-and-screenshots-to-a-theme/119205)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 0\ **Last updated:** [May 31, 2019, 3:34pm UTC](https://meta.discourse.org/t/adding-metadata-and-screenshots-to-a-theme/119205 "2019-05-31T15:34:25Z")
You can add various pieces of metadata to a theme. Some are stored in the about.json file, and some are stored in the locale files. about.json :link: file format info name (string, required): The default name for the th… --- ## [Allow users to select new color palettes](https://meta.discourse.org/t/allow-users-to-select-new-color-palettes/60857)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 24\ **Last updated:** [May 17, 2019, 7:47am UTC](https://meta.discourse.org/t/allow-users-to-select-new-color-palettes/60857 "2019-05-17T07:47:34Z")
:bookmark: This is a guide for making new color palette available for all users to choose from their profile preferences. :person\_raising\_hand: Required user level: Administrator Include a new color palette Go to A… --- ## [Configure custom emoji](https://meta.discourse.org/t/configure-custom-emoji/23365)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 0\ **Last updated:** [February 3, 2019, 11:00pm UTC](https://meta.discourse.org/t/configure-custom-emoji/23365 "2019-02-03T23:00:00Z")
:bookmark: This guide explains how to customize emojis on your Discourse site through selectable emoji sets, uploading new emoji, configuring site settings, and adjusting emoji sizes. :person\_raising\_hand: Required use… --- ## [Perform Google Search Console Verification with Discourse](https://meta.discourse.org/t/perform-google-search-console-verification-with-discourse/107229)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 0\ **Last updated:** [January 23, 2019, 1:05am UTC](https://meta.discourse.org/t/perform-google-search-console-verification-with-discourse/107229 "2019-01-23T01:05:21Z")
:bookmark: This guide describes how to perform Google Search Console (f.k.a Google Webmaster Tools) verification with Discourse. You can verify domain ownership using three methods - by using the site setting in your fo… --- ## [Allow multiple accounts to register from the same IP address](https://meta.discourse.org/t/allow-multiple-accounts-to-register-from-the-same-ip-address/106752)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 0\ **Last updated:** [January 17, 2019, 2:01am UTC](https://meta.discourse.org/t/allow-multiple-accounts-to-register-from-the-same-ip-address/106752 "2019-01-17T02:01:15Z")
:bookmark: This guide explains how to allow multiple accounts to register from the same IP address by adjusting site settings or managing the Screened IPs list. :person\_raising\_hand: Required user level: Administrator … --- ## [Install a new language for Highlight.JS via a theme component](https://meta.discourse.org/t/install-a-new-language-for-highlight-js-via-a-theme-component/292480)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 0\ **Last updated:** [January 3, 2019, 4:47pm UTC](https://meta.discourse.org/t/install-a-new-language-for-highlight-js-via-a-theme-component/292480 "2019-01-03T16:47:47Z")
I’ve just added a hook to our HighlightJS code so now you can use the plugin API to add a custom language for Highlight.JS. Example (using the beancount language definition): const beancountLang = function(e){var c="\[A… --- ## [Pre-launch checklist after migrating from another platform](https://meta.discourse.org/t/pre-launch-checklist-after-migrating-from-another-platform/83996)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 1\ **Last updated:** [April 2, 2018, 7:11pm UTC](https://meta.discourse.org/t/pre-launch-checklist-after-migrating-from-another-platform/83996 "2018-04-02T19:11:53Z")
:memo: We’ve now created a more in-depth checklist: Pre-launch Checklist for Discourse Migrations Here are some things to check before you launch your new Discourse community if you’ve recently migrated to Discourse f… --- ## [Redirect vBulletin URLs to Discourse URLs](https://meta.discourse.org/t/redirect-vbulletin-urls-to-discourse-urls/47394)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 5\ **Last updated:** [January 25, 2018, 2:57pm UTC](https://meta.discourse.org/t/redirect-vbulletin-urls-to-discourse-urls/47394 "2018-01-25T14:57:34Z")
Migrating from vBulletin to Discourse and want to redirect old vBulletin URLs to new Discourse URLs? Read on! :bell: If the base URL of your old forum and new forum is same, you should follow this howto instead: Re… --- ## [Recover from a very slow database](https://meta.discourse.org/t/recover-from-a-very-slow-database/68793)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 2\ **Last updated:** [August 25, 2017, 7:41pm UTC](https://meta.discourse.org/t/recover-from-a-very-slow-database/68793 "2017-08-25T19:41:37Z")
Rarely, the database can get into a state where it is so slow it appears broken (I have seen 3 instances of this issue in the last 4 years) How can you tell you are impacted? It is quite easy to tell the difference bet… --- ## [Configure OneLogin's SAML for Discourse](https://meta.discourse.org/t/configure-onelogins-saml-for-discourse/68295)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 0\ **Last updated:** [August 18, 2017, 7:56am UTC](https://meta.discourse.org/t/configure-onelogins-saml-for-discourse/68295 "2017-08-18T07:56:24Z")
Here’s how to configure Discourse to allow login and registration with OneLogin’s SAML. Configure OneLogin Create OneLogin account Go to OneLogin and create an account. Create new app: SAML Test Connector (IdP w/att… --- ## [Things to consider before deciding to white-label the Discourse Mobile apps](https://meta.discourse.org/t/things-to-consider-before-deciding-to-white-label-the-discourse-mobile-apps/53063)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 0\ **Last updated:** [November 18, 2016, 5:06am UTC](https://meta.discourse.org/t/things-to-consider-before-deciding-to-white-label-the-discourse-mobile-apps/53063 "2016-11-18T05:06:26Z")
Since we released the iOS and Android apps a number of people have asked expressed interest in white labeling the Discourse app. :information\_source: We do not offer a white labeling service and would only consider it … --- ## [Troubleshoot reply by email](https://meta.discourse.org/t/troubleshoot-reply-by-email/42026)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 0\ **Last updated:** [April 4, 2016, 8:49pm UTC](https://meta.discourse.org/t/troubleshoot-reply-by-email/42026 "2016-04-04T20:49:19Z")
If your Discourse does not have incoming email set up, see these topics: Set up reply by email with POP3 polling Configure direct-delivery incoming email for self-hosted sites with Mail-Receiver … --- ## [What to do if your Discourse is compromised](https://meta.discourse.org/t/what-to-do-if-your-discourse-is-compromised/40129)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 0\ **Last updated:** [February 24, 2016, 11:39pm UTC](https://meta.discourse.org/t/what-to-do-if-your-discourse-is-compromised/40129 "2016-02-24T23:39:47Z")
We’ve recently had two reports of Discourse sites that were compromised, likely due to weak admin account passwords. So we’d like to document: what to do when compromise happens what we can do to better prevent this in… --- ## [Restore a Discourse backup manually for development](https://meta.discourse.org/t/restore-a-discourse-backup-manually-for-development/33551)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 0\ **Last updated:** [September 21, 2015, 10:21pm UTC](https://meta.discourse.org/t/restore-a-discourse-backup-manually-for-development/33551 "2015-09-21T22:21:06Z")
You’ve got yourself a Discourse backup file and want to load it into your development database, without using the web UI, or potentially with a different database name. Cool! This will assume you already have a Postgres… --- ## [Creating bug reports for Discourse on Meta](https://meta.discourse.org/t/creating-bug-reports-for-discourse-on-meta/33070)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 0\ **Last updated:** [September 9, 2015, 3:46pm UTC](https://meta.discourse.org/t/creating-bug-reports-for-discourse-on-meta/33070 "2015-09-09T15:46:47Z")
:bookmark: This is a guide for reporting about bugs you find in Discourse using the correct channels. :person\_raising\_hand: Required user level: Anyone can report bugs When you encounter an issue that breaks or preve… --- ## [Use a subfolder (path prefix) to serve Discourse with multiple servers sharing a domain](https://meta.discourse.org/t/use-a-subfolder-path-prefix-to-serve-discourse-with-multiple-servers-sharing-a-domain/30514)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 0\ **Last updated:** [June 26, 2015, 8:57pm UTC](https://meta.discourse.org/t/use-a-subfolder-path-prefix-to-serve-discourse-with-multiple-servers-sharing-a-domain/30514 "2015-06-26T20:57:34Z")
Let’s say you have a WordPress blog on http://=DOMAIN=, and you want to serve your Discourse forums (which run on a different server) from http://=DOMAIN==PATH=. How do you do that? Note: This won’t work for serving mu… --- ## [Optimizing Discourse search for CJK languages](https://meta.discourse.org/t/optimizing-discourse-search-for-cjk-languages/28741)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 0\ **Last updated:** [May 13, 2015, 2:57am UTC](https://meta.discourse.org/t/optimizing-discourse-search-for-cjk-languages/28741 "2015-05-13T02:57:38Z")
:bookmark: This guide explains how to adjust Discourse settings to better accommodate Chinese, Japanese, and Korean (CJK) languages in site search. :person\_raising\_hand: Required user level: Administrator Discourse’s… --- ## [Change the maximum attachment/upload size](https://meta.discourse.org/t/change-the-maximum-attachment-upload-size/26435)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 0\ **Last updated:** [March 17, 2015, 2:00pm UTC](https://meta.discourse.org/t/change-the-maximum-attachment-upload-size/26435 "2015-03-17T14:00:41Z")
:bookmark: This guide explains how to change the maximum attachment upload size for self-hosted Discourse instances. :person\_raising\_hand: Required user level: System Admin The default attachment upload size limit is… --- ## [Configure mailbox in Google Apps for user-friendly incoming email addresses for discourse categories (with screenshots)](https://meta.discourse.org/t/configure-mailbox-in-google-apps-for-user-friendly-incoming-email-addresses-for-discourse-categories-with-screenshots/15374)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 0\ **Last updated:** [May 7, 2014, 12:43am UTC](https://meta.discourse.org/t/configure-mailbox-in-google-apps-for-user-friendly-incoming-email-addresses-for-discourse-categories-with-screenshots/15374 "2014-05-07T00:43:45Z")
I had a bit of trouble figuring out how to set up the mailbox in google apps to work with Discourse so that there is a user-friendly incoming email address for each category. Here are some screenshots that show how I did… --- ## [Troubleshoot docker installation issues](https://meta.discourse.org/t/troubleshoot-docker-installation-issues/13657)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 0\ **Last updated:** [March 12, 2014, 3:49am UTC](https://meta.discourse.org/t/troubleshoot-docker-installation-issues/13657 "2014-03-12T03:49:02Z")
I just ran: cd /var/discourse git pull ./launcher rebuild app And am getting: Your Docker installation is not working correctly See: https://meta.discourse.org/t/docker-error-on-bootstrap/13657/18?u=sam W… --- ## [Migrate an old Discourse install to Docker](https://meta.discourse.org/t/migrate-an-old-discourse-install-to-docker/12439)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 0\ **Last updated:** [February 5, 2014, 1:24am UTC](https://meta.discourse.org/t/migrate-an-old-discourse-install-to-docker/12439 "2014-02-05T01:24:41Z")
:information\_source: 2022.10.21 @pfaffman adds: If you are somehow using a non-docker installation in 2022 then this guide might help you. There is not much way to test it, but it should work. Kept for historical pu… --- ## [Message Format support for localization](https://meta.discourse.org/t/message-format-support-for-localization/7035)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 0\ **Last updated:** [May 31, 2013, 1:17am UTC](https://meta.discourse.org/t/message-format-support-for-localization/7035 "2013-05-31T01:17:09Z")
Guidelines for Translators In Discourse all Message Format strings have a key that ends with “\_MF”. The Crowdin Editor has a preview that allows you to experiment with various values which is quite helpful for checking y… --- ## [Contributing to Discourse development](https://meta.discourse.org/t/contributing-to-discourse-development/3823)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 0\ **Last updated:** [February 23, 2013, 5:46am UTC](https://meta.discourse.org/t/contributing-to-discourse-development/3823 "2013-02-23T05:46:11Z")
:bookmark: This guide is designed for those who wish to contribute to the Discourse open-source project, detailing the setup and conventions necessary for effective collaboration. :person\_raising\_hand: Required user le… [Previous page](https://meta.discourse.org/c/documentation/10.md?page=16)