Documentation

Contributing Guides on how to contribute to the Discourse open-source project. (Index) Self-Hosting Documentation and guides for people who self-host their Discourse sites. (Index) Developer Guides Documentation about extending Discourse with plugins, themes, and theme components, working with the core code, and using the Discourse API. (Index) Hosted Customers Documentation and guides for people who run Discourse-hosted sites (Index) Migrating to Discourse Guides and advice on how to migrate your forum to Discourse. (Index) Using Discourse Topics showing how to Discourse by reading and writing content, and navigating Discourse sites. (Index) Integrations Documentation about connecting Discourse with other platforms and services. (Index) Site Management Documentation covering the configuration, moderation, and ongoing management of your Discourse community - useful for site owners, administrators, and moderators. (Index)

Topic	Replies	Views	Activity
Discourse Moderation Guide - Part 1: Getting Started Site Management moderation , explanation	5	273162	June 25, 2026
Setup DiscourseConnect - Official Single-Sign-On for Discourse (sso) Integrations sso , discourseconnect , configuring , how-to	46	459882	May 27, 2026
Manually update Discourse and Docker image to latest Self-Hosting how-to	13	111400	January 16, 2025
Understanding Discourse for new users Using Discourse reference	2	206188	September 18, 2025
Install plugins on a self-hosted site Self-Hosting how-to	42	264872	March 10, 2026
Change the domain name or rename your Discourse Self-Hosting how-to , domains	7	204540	June 19, 2025
Configure Google login for Discourse Integrations sso , how-to , social-auth	5	238188	July 15, 2025
Developing Discourse Themes & Theme Components Developer Guides reference , tutorial , theme-guides	14	109005	March 18, 2025
Run other websites on the same machine as Discourse Self-Hosting how-to , advanced-setup	66	139863	June 30, 2026
Set up HTTPS support with Let's Encrypt Self-Hosting how-to , domains	2	111016	February 25, 2024
Embed Discourse comments on another website via Javascript Integrations embedding , how-to	127	306279	June 2, 2026
Page Publishing Site Management how-to , page-publishing , content	65	28033	January 23, 2026
Developing Discourse Plugins - Part 1 - Create a basic plugin Developer Guides plugin-guides , tutorial	32	84545	July 8, 2025
Set up file and image uploads to S3 Self-Hosting configuring , how-to	35	121575	October 25, 2025
Trust Level Permissions Reference Using Discourse trust-levels , reference	31	27935	August 27, 2025
Configure direct-delivery incoming email for self-hosted sites with Mail-Receiver Self-Hosting email , how-to , advanced-setup , mail-receiver	76	51545	March 27, 2026
Creating and managing events Using Discourse events , how-to	4	39697	February 12, 2026
Beginner's guide to using Discourse Themes Site Management reference , customization	12	85938	July 9, 2026
Configure Facebook login for Discourse Integrations sso , how-to , social-auth	37	332813	June 3, 2026
Reverse engineer the Discourse API Integrations rest-api , how-to	0	38276	September 29, 2014
Install Discourse on macOS for development Developer Guides dev-install , how-to	102	117468	April 24, 2026
Install the Discourse Theme CLI console app to help you build themes Developer Guides how-to , theme-guides	16	32515	July 30, 2026
Configuring X login and rich embeds for Discourse Integrations sso , how-to , social-auth	142	229966	January 20, 2026
Move your Discourse Instance to a Different Server Self-Hosting migrations , how-to	11	294170	August 11, 2026
Adding a table to your post using markdown Using Discourse tutorial	26	34527	June 9, 2025
Restore a backup from the command line Self-Hosting how-to	18	22664	May 18, 2025
Discourse REST API Documentation Integrations rest-api , reference Discourse API Please view the Discourse API Documentation site for detailed info: https://docs.discourse.org :information_source: Authentication API requests must use HTTP header based authentication. Pass your Api-…	0	129061	December 1, 2014
Create a swapfile for your Linux server Self-Hosting	5	78302	December 18, 2024
Customize text in Discourse Site Management configuring , how-to , customization	12	24803	July 25, 2026
Install Discourse for development using Docker Developer Guides docker , dev-install , how-to	226	93380	May 22, 2026
Set up reply by email with POP3 polling Self-Hosting email , how-to	1	303826	September 2, 2025
Configure an S3 compatible object storage provider for uploads Self-Hosting cdn , configuring , how-to , reference	267	52413	September 15, 2026
Replace a string in all posts Self-Hosting how-to	26	23708	December 9, 2025
Administrative Bulk Operations Self-Hosting configuring , reference	9	14713	June 12, 2026
Understanding user statuses, roles, and permissions Site Management reference , users	0	32569	November 2, 2015
Creating a link to start a new topic with pre-filled information Using Discourse how-to	3	24598	October 16, 2024
Install Discourse on Ubuntu or Debian for Development Developer Guides dev-install , how-to	83	202992	June 22, 2025
Configure automatic backups for Discourse Self-Hosting backups , how-to	44	304878	May 19, 2026
Creating and managing polls Using Discourse polls , how-to	26	43157	September 22, 2026
Use Discourse as an identity provider (SSO, DiscourseConnect) Integrations sso , discourseconnect , how-to	142	52454	November 9, 2024
Troubleshoot email on a new Discourse install Self-Hosting email , configuring , how-to	36	185187	April 27, 2026
House Ad Templates Site Management advertising , how-to	31	11241	January 8, 2026
Allow SSL / HTTPS for your Discourse Docker setup Self-Hosting docker , how-to , advanced-setup	0	259160	March 18, 2014
Mitigate XSS Attacks with Content Security Policy Site Management how-to , content-security-policy	30	25654	June 13, 2023
Scheduling topics for future publication Site Management how-to , topic-timers	0	19370	April 10, 2017
Replace Discourse's default SVG icons with custom icons in a theme Developer Guides how-to , theme-guides	10	9369	February 24, 2026
Understanding closed, unlisted, and archived topics Site Management explanation	3	32563	July 13, 2025
Installing a theme or theme component Site Management how-to , customization	0	58067	May 31, 2017
Install Discourse on Windows for development Developer Guides dev-install , how-to	16	75135	April 22, 2026
Linking to a heading within a post or topic Using Discourse how-to	7	25485	November 23, 2025