# Documentation **URL:** https://meta.discourse.org/c/documentation/10.md?ascending=false&page=6 [Latest](https://meta.discourse.org/latest.md) · [Categories](https://meta.discourse.org/categories.md) · [Tags](https://meta.discourse.org/tags.md) **Page:** 7 --- ## [Configure API Keys for OpenAI](https://meta.discourse.org/t/configure-api-keys-for-openai/280783)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 11\ **Last updated:** [November 11, 2024, 7:04am UTC](https://meta.discourse.org/t/configure-api-keys-for-openai/280783 "2024-11-11T07:04:27Z")
:bookmark: This guide explains how to configure API keys for OpenAI to enable Discourse AI features that require 3rd party LLM keys. :person\_raising\_hand: Required user level: Administrator In this example, we are us… --- ## [Discourse AI - Periodic summary reports](https://meta.discourse.org/t/discourse-ai-periodic-summary-reports/290236)
**Author:** [@sam](https://meta.discourse.org/u/sam)\ **Replies:** 2\ **Last updated:** [March 20, 2026, 1:52pm UTC](https://meta.discourse.org/t/discourse-ai-periodic-summary-reports/290236 "2026-03-20T13:52:40Z")
We are pleased to announce the release of a new feature within the Discourse AI plugin: Periodic summary reports using AI. This Discourse AI / Discourse Automation feature is designed to provide people with automated, hi… --- ## [Helper - captioning images](https://meta.discourse.org/t/helper-captioning-images/336100)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 9\ **Last updated:** [September 2, 2025, 11:07am UTC](https://meta.discourse.org/t/helper-captioning-images/336100 "2025-09-02T11:07:39Z")
:bookmark: This guide explains how to enable and configure AI powered image captions, which is part of the Helper feature of Discourse AI plugin. :person\_raising\_hand: Required user level: Administrator Image caption… --- ## [Setup HubSpot chat Integration](https://meta.discourse.org/t/setup-hubspot-chat-integration/128777)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 10\ **Last updated:** [June 17, 2025, 1:02am UTC](https://meta.discourse.org/t/setup-hubspot-chat-integration/128777 "2025-06-17T01:02:56Z")
Do you want to integrate a CSM on Discourse? Let’s see how to integrate the HubSpot chat on Discourse! create an account to HubSpot select Chat customize the interface and the availability as you wish … --- ## [Enable group sync from Google Workplace](https://meta.discourse.org/t/enable-group-sync-from-google-workplace/226850)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 7\ **Last updated:** [April 11, 2025, 2:03am UTC](https://meta.discourse.org/t/enable-group-sync-from-google-workplace/226850 "2025-04-11T02:03:14Z")
To get started, configure Google login according to these instructions: Then, follow these steps: In the google dashboard for your OAuth integration, go to “APIs and Services”, and add "Admin SDK → → Go to … --- ## [Set up structured tagging with tag groups and category tag restrictions](https://meta.discourse.org/t/set-up-structured-tagging-with-tag-groups-and-category-tag-restrictions/48260)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 0\ **Last updated:** [August 5, 2016, 3:25pm UTC](https://meta.discourse.org/t/set-up-structured-tagging-with-tag-groups-and-category-tag-restrictions/48260 "2016-08-05T15:25:43Z")
Tag support is a core feature of Discourse. In this How-To I’ll go through setting up a tag schema like Car Talk uses. We’ll want to achieve these things: Tags for car makes and car models. Only allow the car make and… --- ## [Grant a badge to individual users manually](https://meta.discourse.org/t/grant-a-badge-to-individual-users-manually/29426)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 0\ **Last updated:** [May 29, 2015, 6:38pm UTC](https://meta.discourse.org/t/grant-a-badge-to-individual-users-manually/29426 "2015-05-29T18:38:57Z")
:bookmark: This is a guide for manually granting a custom badge to individual users on Discourse. :person\_raising\_hand: Required user level: Administrator In this guide, you’ll learn how to create and manually gran… --- ## [Customize the header with links, icons, or menus](https://meta.discourse.org/t/customize-the-header-with-links-icons-or-menus/13368)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 0\ **Last updated:** [January 21, 2019, 5:07pm UTC](https://meta.discourse.org/t/customize-the-header-with-links-icons-or-menus/13368 "2019-01-21T17:07:00Z")
:bookmark: This guide is crafted for users who want to spruce up their site’s header by adding links, icons, or menus. Whether you’re using simple theme components or opting for more intricate customizations, this manua… --- ## [Update the FAQ, Privacy Policy, and Terms of Service](https://meta.discourse.org/t/update-the-faq-privacy-policy-and-terms-of-service/18074)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 0\ **Last updated:** [July 25, 2014, 9:05pm UTC](https://meta.discourse.org/t/update-the-faq-privacy-policy-and-terms-of-service/18074 "2014-07-25T21:05:24Z")
:bookmark: This guide explains how to update the FAQ, Privacy Policy, and Terms of Service pages in Discourse. :person\_raising\_hand: Required user level: Administrator Updating the FAQ, Privacy Policy, and Terms of S… --- ## [Flagging a post for moderator attention](https://meta.discourse.org/t/flagging-a-post-for-moderator-attention/32783)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 8\ **Last updated:** [August 1, 2024, 8:57pm UTC](https://meta.discourse.org/t/flagging-a-post-for-moderator-attention/32783 "2024-08-01T20:57:31Z")
:bookmark: This guide explains how to flag a post for moderator attention in Discourse, when you should use this feature, and what happens after a post is flagged. :person\_raising\_hand: Required user level: Trust Level… --- ## [Understanding "helpful flags" on user profiles](https://meta.discourse.org/t/understanding-helpful-flags-on-user-profiles/25385)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 0\ **Last updated:** [February 19, 2015, 3:30am UTC](https://meta.discourse.org/t/understanding-helpful-flags-on-user-profiles/25385 "2015-02-19T03:30:14Z")
:bookmark: This topic explains what “helpful flags” means on a user’s profile page and how this metric is calculated. :person\_raising\_hand: Required user level: Moderators and Admin When you view a user’s profile on … --- ## [Use Discourse as an identity provider (SSO, DiscourseConnect)](https://meta.discourse.org/t/use-discourse-as-an-identity-provider-sso-discourseconnect/32974)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 142\ **Last updated:** [November 9, 2024, 11:50am UTC](https://meta.discourse.org/t/use-discourse-as-an-identity-provider-sso-discourseconnect/32974 "2024-11-09T11:50:05Z")
So you want to use Discourse as an identity provider for your own web app? Great! Let’s get started. Enable DiscourseConnect provider setting Under Discourse admin site settings (/admin/site\_settings) enable setting en… --- ## [Create an admin account from the console](https://meta.discourse.org/t/create-an-admin-account-from-the-console/17274)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 1\ **Last updated:** [January 2, 2025, 5:02pm UTC](https://meta.discourse.org/t/create-an-admin-account-from-the-console/17274 "2025-01-02T17:02:18Z")
:bookmark: This guide provides instructions for creating an admin account or granting admin privileges using the console in a self-hosted Discourse installation. :person\_raising\_hand: Required user level: System Admini… --- ## [Discourse REST API Documentation](https://meta.discourse.org/t/discourse-rest-api-documentation/22706)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 0\ **Last updated:** [December 1, 2014, 2:42pm UTC](https://meta.discourse.org/t/discourse-rest-api-documentation/22706 "2014-12-01T14:42:20Z")
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-… --- ## [Reverse engineer the Discourse API](https://meta.discourse.org/t/reverse-engineer-the-discourse-api/20576)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 0\ **Last updated:** [September 29, 2014, 1:22am UTC](https://meta.discourse.org/t/reverse-engineer-the-discourse-api/20576 "2014-09-29T01:22:40Z")
Discourse is backed by a complete JSON api. Anything you can do on the site you can also do using the JSON api. The API is documented at docs.discourse.org. You can also use the discourse\_api Ruby gem as a client librar… --- ## [Use the Discourse API ruby gem](https://meta.discourse.org/t/use-the-discourse-api-ruby-gem/17587)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 0\ **Last updated:** [July 15, 2014, 3:29am UTC](https://meta.discourse.org/t/use-the-discourse-api-ruby-gem/17587 "2014-07-15T03:29:15Z")
So you want to use Discourse API? Great! Let’s get started. Set up Discourse development environment Set up Discourse development environment using our Windows, macOS or Ubuntu guide. Clone Discourse API Gem Now that… --- ## [Manually update Discourse and Docker image to latest](https://meta.discourse.org/t/manually-update-discourse-and-docker-image-to-latest/23325)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 13\ **Last updated:** [January 16, 2025, 11:14am UTC](https://meta.discourse.org/t/manually-update-discourse-and-docker-image-to-latest/23325 "2025-01-16T11:14:13Z")
:bookmark: This guide provides step-by-step instructions for manually updating Discourse, the Docker container, and the Ubuntu operating system on a self-hosted setup. :person\_raising\_hand: Required user level: System … --- ## [Recover a user who was deleted as a spammer](https://meta.discourse.org/t/recover-a-user-who-was-deleted-as-a-spammer/33372)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 0\ **Last updated:** [September 16, 2015, 8:44pm UTC](https://meta.discourse.org/t/recover-a-user-who-was-deleted-as-a-spammer/33372 "2015-09-16T20:44:27Z")
:bookmark: This guide explains how to recover users and their content after they were mistakenly deleted as spammers. :person\_raising\_hand: Required user level: Administrator When a user is mistakenly flagged as a sp… --- ## [Configure a firewall for Discourse](https://meta.discourse.org/t/configure-a-firewall-for-discourse/20584)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 5\ **Last updated:** [March 25, 2025, 11:14pm UTC](https://meta.discourse.org/t/configure-a-firewall-for-discourse/20584 "2025-03-25T23:14:23Z")
If you are using a standard Docker based Discourse install, the following Uncomplicated Firewall rules will protect any non-Docker services on your server: ufw allow http ufw allow https ufw allow ssh ufw enable That i… --- ## [Create a swapfile for your Linux server](https://meta.discourse.org/t/create-a-swapfile-for-your-linux-server/13880)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 5\ **Last updated:** [December 18, 2024, 3:03pm UTC](https://meta.discourse.org/t/create-a-swapfile-for-your-linux-server/13880 "2024-12-18T15:03:04Z")
:bulb: For servers with \<= 4GB of RAM, running ./discourse-setup will prompt for and automatically create a 2GB swapfile. Most cloud virtual machine providers do not set up swapfiles as part of their server provisioni… --- ## [Creating pre-filled personal message links](https://meta.discourse.org/t/creating-pre-filled-personal-message-links/35984)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 6\ **Last updated:** [April 28, 2025, 2:03pm UTC](https://meta.discourse.org/t/creating-pre-filled-personal-message-links/35984 "2025-04-28T14:03:34Z")
:bookmark: This guide describes how to create a link to start a new personal message with pre-filled information, including best practices. :person\_raising\_hand: Required user level: All users Discourse allows you to… --- ## [Change the domain name or rename your Discourse](https://meta.discourse.org/t/change-the-domain-name-or-rename-your-discourse/16098)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 7\ **Last updated:** [June 19, 2025, 6:23pm UTC](https://meta.discourse.org/t/change-the-domain-name-or-rename-your-discourse/16098 "2025-06-19T18:23:25Z")
:bookmark: This guide explains how-to change the domain name of your Discourse site, and includes information about setting up DNS changes, editing configuration files, updating site settings, and correcting social logi… --- ## [Configuring Activity Summary emails](https://meta.discourse.org/t/configuring-activity-summary-emails/36627)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 6\ **Last updated:** [June 30, 2025, 2:28pm UTC](https://meta.discourse.org/t/configuring-activity-summary-emails/36627 "2025-06-30T14:28:58Z")
:bookmark: This guide explains how to configure and manage activity summary emails in Discourse, including user and admin options, customization, and troubleshooting. :person\_raising\_hand: Required user level: Administ… --- ## [Configure Google login for Discourse](https://meta.discourse.org/t/configure-google-login-for-discourse/15858)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 5\ **Last updated:** [July 15, 2025, 5:06pm UTC](https://meta.discourse.org/t/configure-google-login-for-discourse/15858 "2025-07-15T17:06:01Z")
:bookmark: This guide explains how to set up Google login integration for your Discourse site by configuring OAuth2 credentials in the Google Cloud Console. :person\_raising\_hand: Required user level: Administrator O… --- ## [Configuring wiki settings](https://meta.discourse.org/t/configuring-wiki-settings/30802)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 1\ **Last updated:** [August 28, 2025, 10:01pm UTC](https://meta.discourse.org/t/configuring-wiki-settings/30802 "2025-08-28T22:01:27Z")
:bookmark: This guide explains how to configure wiki settings to meet your community’s needs, including how to determine who can create and edit wiki posts. :person\_raising\_hand: Required user level: Administrator W… --- ## [Set up reply by email with POP3 polling](https://meta.discourse.org/t/set-up-reply-by-email-with-pop3-polling/14003)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 1\ **Last updated:** [September 2, 2025, 11:05am UTC](https://meta.discourse.org/t/set-up-reply-by-email-with-pop3-polling/14003 "2025-09-02T11:05:11Z")
So you’d like to set up reply via email support for your Discourse forum. :mega: Reply via email is pre-configured and enabled by default on all discourse.org hosted sites. The guide below only applies to those self-ho… --- ## [Migrate a phpBB3 forum to Discourse](https://meta.discourse.org/t/migrate-a-phpbb3-forum-to-discourse/30810)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 464\ **Last updated:** [September 4, 2025, 1:38pm UTC](https://meta.discourse.org/t/migrate-a-phpbb3-forum-to-discourse/30810 "2025-09-04T13:38:09Z")
So, you discovered Discourse and want to know how to migrate from your existing phpBB3 forum? Great! Then keep on reading. This guide will show you how to use the phpBB3 import script for importing from phpBB 3.0 up to 3… --- ## [Enable a CDN for your Discourse](https://meta.discourse.org/t/enable-a-cdn-for-your-discourse/14857)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 72\ **Last updated:** [October 4, 2025, 12:09pm UTC](https://meta.discourse.org/t/enable-a-cdn-for-your-discourse/14857 "2025-10-04T12:09:57Z")
So you’d like to use a CDN to speed up worldwide access to common assets on your Discourse forum? You might want to go all-in and Set up file and image uploads to S3 (see also Configure an S3 compatible object storage pr… --- ## [Set up file and image uploads to S3](https://meta.discourse.org/t/set-up-file-and-image-uploads-to-s3/7229)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 35\ **Last updated:** [October 25, 2025, 2:43am UTC](https://meta.discourse.org/t/set-up-file-and-image-uploads-to-s3/7229 "2025-10-25T02:43:17Z")
So, you want to use S3 to handle image uploads? Here’s the definitive guide, but also see Configure an S3 compatible object storage provider for uploads to see how to configure your app.yml. S3 registration Head over t… --- ## [Allow SSL / HTTPS for your Discourse Docker setup](https://meta.discourse.org/t/allow-ssl-https-for-your-discourse-docker-setup/13847)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 0\ **Last updated:** [March 18, 2014, 11:45pm UTC](https://meta.discourse.org/t/allow-ssl-https-for-your-discourse-docker-setup/13847 "2014-03-18T23:45:27Z")
This guide is likely out of date as there are now very few reasons not to use the built-in Let’s Encrypt certificate that Just Works. See also: 2023-04-10 @pfaffman says: This is left here mostly for historical purpos… [Previous page](https://meta.discourse.org/c/documentation/10.md?ascending=false&page=5) [Next page](https://meta.discourse.org/c/documentation/10.md?ascending=false&page=7)