Documentation

Self-Hosting Documentation and guides for people who self-host their Discourse sites. (Index) Contributing Guides on how to contribute to the Discourse open-source project. (Index) Developer Guides Documentation about extending Discourse with plugins, themes, and theme components, working with the core code, and using the Discourse API. (Index) Migrating to Discourse Guides and advice on how to migrate your forum to Discourse. (Index) Hosted Customers Documentation and guides for people who run Discourse-hosted sites (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	272961	June 25, 2026
Setup DiscourseConnect - Official Single-Sign-On for Discourse (sso) Integrations sso , discourseconnect , configuring , how-to	46	459574	May 27, 2026
Manually update Discourse and Docker image to latest Self-Hosting how-to	13	111323	January 16, 2025
Understanding Discourse for new users Using Discourse reference	2	205950	September 18, 2025
Install plugins on a self-hosted site Self-Hosting how-to	42	264635	March 10, 2026
Change the domain name or rename your Discourse Self-Hosting how-to , domains	7	204485	June 19, 2025
Configure Google login for Discourse Integrations sso , how-to , social-auth	5	238117	July 15, 2025
Developing Discourse Themes & Theme Components Developer Guides reference , tutorial , theme-guides	14	108883	March 18, 2025
Run other websites on the same machine as Discourse Self-Hosting how-to , advanced-setup	66	139701	June 30, 2026
Set up HTTPS support with Let's Encrypt Self-Hosting how-to , domains	2	110980	February 25, 2024
Embed Discourse comments on another website via Javascript Integrations embedding , how-to	127	306051	June 2, 2026
Page Publishing Site Management how-to , page-publishing , content	65	27940	January 23, 2026
Developing Discourse Plugins - Part 1 - Create a basic plugin Developer Guides plugin-guides , tutorial	32	84449	July 8, 2025
Set up file and image uploads to S3 Self-Hosting configuring , how-to	35	121483	October 25, 2025
Trust Level Permissions Reference Using Discourse trust-levels , reference	31	27818	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	51409	March 27, 2026
Creating and managing events Using Discourse events , how-to	4	39642	February 12, 2026
Beginner's guide to using Discourse Themes Site Management reference , customization	12	85858	July 9, 2026
Configure Facebook login for Discourse Integrations sso , how-to , social-auth	37	332771	June 3, 2026
Reverse engineer the Discourse API Integrations rest-api , how-to	0	38188	September 29, 2014
Install Discourse on macOS for development Developer Guides dev-install , how-to	102	117187	April 24, 2026
Install the Discourse Theme CLI console app to help you build themes Developer Guides how-to , theme-guides	16	32461	July 30, 2026
Configuring X login and rich embeds for Discourse Integrations sso , how-to , social-auth	142	229608	January 20, 2026
Move your Discourse Instance to a Different Server Self-Hosting migrations , how-to	11	294123	August 11, 2026
Adding a table to your post using markdown Using Discourse tutorial	26	34463	June 9, 2025
Restore a backup from the command line Self-Hosting how-to	18	22631	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	129003	December 1, 2014
Create a swapfile for your Linux server Self-Hosting	5	78292	December 18, 2024
Customize text in Discourse Site Management configuring , how-to , customization	12	24767	July 25, 2026
Install Discourse for development using Docker Developer Guides docker , dev-install , how-to	226	93100	May 22, 2026
Set up reply by email with POP3 polling Self-Hosting email , how-to	1	303769	September 2, 2025
Configure an S3 compatible object storage provider for uploads Self-Hosting cdn , configuring , how-to , reference	267	51946	September 15, 2026
Replace a string in all posts Self-Hosting how-to	26	23675	December 9, 2025
Administrative Bulk Operations Self-Hosting configuring , reference	9	14679	June 12, 2026
Understanding user statuses, roles, and permissions Site Management reference , users	0	32511	November 2, 2015
Creating a link to start a new topic with pre-filled information Using Discourse how-to	3	24557	October 16, 2024
Install Discourse on Ubuntu or Debian for Development Developer Guides dev-install , how-to	83	202628	June 22, 2025
Configure automatic backups for Discourse Self-Hosting backups , how-to	44	304787	May 19, 2026
Creating and managing polls Using Discourse polls , how-to	26	43056	September 22, 2026
Use Discourse as an identity provider (SSO, DiscourseConnect) Integrations sso , discourseconnect , how-to	142	52211	November 9, 2024
Troubleshoot email on a new Discourse install Self-Hosting email , configuring , how-to	36	184851	April 27, 2026
House Ad Templates Site Management advertising , how-to	31	11216	January 8, 2026
Allow SSL / HTTPS for your Discourse Docker setup Self-Hosting docker , how-to , advanced-setup	0	259126	March 18, 2014
Mitigate XSS Attacks with Content Security Policy Site Management how-to , content-security-policy	30	25625	June 13, 2023
Scheduling topics for future publication Site Management how-to , topic-timers	0	19347	April 10, 2017
Replace Discourse's default SVG icons with custom icons in a theme Developer Guides how-to , theme-guides	10	9294	February 24, 2026
Understanding closed, unlisted, and archived topics Site Management explanation	3	32522	July 13, 2025
Installing a theme or theme component Site Management how-to , customization	0	57981	May 31, 2017
Install Discourse on Windows for development Developer Guides dev-install , how-to	16	75030	April 22, 2026
Linking to a heading within a post or topic Using Discourse how-to	7	25460	November 23, 2025