Subfolder support with Docker

subfolder
docker

(Neil Lalonde) #1

To serve Discourse from a subfolder (a.k.a. with a path prefix) on your domain, like http://www.example.com/forum, here’s how to do it!

Docker config

In the env section of your docker container yml file, add the DISCOURSE_RELATIVE_URL_ROOT setting with the subfolder you want to use. Make sure it does not end with a /.

env:
  ...
  DISCOURSE_RELATIVE_URL_ROOT: /forum

The run section needs some changes to send all Discourse routes to the right place. Here is a complete run section with subfolder support:

run:
    - exec:
        cd: $home
        cmd:
          - mkdir -p public/forum
          - cd public/forum && ln -s ../uploads && ln -s ../backups
    - replace:
       global: true
       filename: /etc/nginx/conf.d/discourse.conf
       from: proxy_pass http://discourse;
       to: |
          rewrite ^/(.*)$ /forum/$1 break;
          proxy_pass http://discourse;
    - replace:
       filename: /etc/nginx/conf.d/discourse.conf
       from: etag off;
       to: |
          etag off;
          location /forum {
             rewrite ^/forum/?(.*)$ /$1;
          }
    - replace:
         filename: /etc/nginx/conf.d/discourse.conf
         from: $proxy_add_x_forwarded_for
         to: $http_your_original_ip_header
         global: true

$http_your_original_ip_header stands for Your-Original-Ip-Header, which is a trusted Header you set on the origin which contains the actual client IP.

This is required cause traffic passes through a central proxy, if Discourse happens to have a public IP you can spoof it. If Discourse is private you may be able to get aways with X-Forwarded-For

After making these changes, bootstrap your Docker container as usual, or rebuild if you’re changing an existing container.

./launcher bootstrap app

or

./launcher rebuild app

Attached is a complete example yml file of a standalone container.

subfolder-sample.yml (3.1 KB)

Rate limiting concerns

If you are going for this setup you probably want to rate limit requests prior to them landing on NGINX in the container, that means you probably will avoid using our rate limiting template. It is very hard to configure NGINX in the container to limit on a remapped IP and would require complex changes to the template.

After Install

You need to configure the long polling base url to the subfolder value, like this in admin / site settings:

long polling base url: /forum/

Or you can run hook to add long_polling_base_url after install:

run:
  - exec: rails r "SiteSetting.long_polling_base_url='/forum/'"

Existing posts

If you did this with an existing site that wasn’t on a subdomain, you’ll find that your uploads are broken. There’s a tool that can help fix all paths to include the subfolder. In the Discourse directory (typically /var/www/discourse'), run it like this after taking a backup:

RAILS_ENV=production bundle exec script/discourse remap '/uploads' '/forum/uploads'

See also: Discourse in a subfolder, multiple servers sharing a domain for more esoteric setups.

Discourse Official Statement about Subfolder setup

We support subfolder setups for our hosted customers at the enterprise level and up. Due to heavy technical setup complexity we strongly recommend you do not use this setup unless you are very experienced in custom subfolder setups.

It is critical you have a deep understanding of

  • NGINX setup in the Discourse Docker container
  • Secure original IP forwarding using custom headers in the proxy chain
  • Rate limiting in front proxy server

If this all sounds odd and strange to you we strongly recommend you avoid this setup.

robots.txt

Now that Discourse is running on a subfolder, it cannot serve its robots.txt file to control which routes are crawled by web crawlers. Crawlers will be looking at your main site’s robots.txt file (http://www.example.com/robots.txt). You need to copy the contents of Discourse’s robots.txt file (found at http://www.example.com/forum/robots.txt) and put it in your main site’s robots.txt file.


How can I change my installation from forum.website.com to www.website.com/forum?
Run Discourse in a Subdirectory
Moving Discourse to subdirectory caused all uploads to break
Discourse in a subfolder, multiple servers sharing a domain
Uploaded avatars and Gravatar not working with subfolder installation
Last chance for "subfolder support"
Install to subfolder instead of subdomain (SEO optimization)
Moving Discourse to subdirectory caused all uploads to break
Is it possible to install discourse inside a directory?
Subfolder with SSL and nginx reverse proxy
Message Bus doesn't respect subfolder
Problem redirect from another server to Discourse server
Subfolder Issues
Last chance for "subfolder support"
Launch Discourse on www.example.com/meta/ In a web folder type
Trainling slash and subfolder setup
Non-standard port breaks uploads
Install Discourse as subfolder within Wordpress website?
Embed whole Discourse board into Wordpresspage
Discourse behind proxy (different domains)
Random Network Error, Especially on Mobile
Backup upload failing
Redirect to discourse from a route in another domain
Redirect to discourse from a route in another domain
Problem with discourse in a subfolder
Install Discourse as subfolder within Wordpress website?
Looking for a developper
Subfolder Issues
Switching forum from subdomain to sub directory
All IPs recorded as 127.0.0.1
/images/ folder returns 404 in sub-folder install
Wrong redirect after login in discourse subfolder
Install Discourse into domain.com/forums
SetupWizard, blank screen, JS Error "`virtual-dom"
Trouble connecting drupal and discourse
National Flags - Display user nationality in Discourse
Installation on v-server as a subfolder with other services in subfolders using apache
Discourse nginx conf
Discourse in a subfolder, multiple servers sharing a domain
Discourse nginx conf
Reverse Proxy rewrites domain in external links in posts
"Failed to create swap, sorry!"
Discourse embedded on my WP
Generals Subfolder recommendations and tips
Inheriting discourse install - need some assistance
Issues setting up subfolder support in Discourse
Wiki topics look incredibly out of date?
Moving Discourse to subdirectory caused all uploads to break
Feasible to reverse proxy using qualifier in URL?
Upgrade doesn't work when installed with subfolder
Discourse CDN set up with KeyCDN
Message Bus Broken With DISCOURSE_RELATIVE_URL_ROOT
How to point to specific path like domain.com/forum?
Message bus does not respect subfolder during update process
Wiki Posts Not Green?
Running Discourse out of a folder, on a server running Wordpress with Apache, with SSL support
Running Discourse out of a folder, on a server running Wordpress with Apache, with SSL support
Running discourse on non-root path
(Sam Saffron) #99

:warning: Please discuss the merits of subfolder vs non-subfolder on separate topics.

Any discussion about the subfolder setup here will likely be integrated into the top post and deleted.

I just edited the OP with more warnings!