Serve Static File

(Jay Pfaffman) #1

Want to serve a static file at the root of your Discourse server?

Here’s what to do. In the bottom of your app.yml file, down in the custom commands section, do something like this:

## Remember, this is YAML syntax - you can only have one block with a name
  - exec: echo "Beginning of custom commands"
  - file:
     path: /var/www/discourse/public/myfile.txt
     chmod: "+r"
     contents: |
       Stuff that's in the file goes here.
  - exec: echo "End of custom commands"

And . /launcher rebuild app
The file will then be accessible as

(Jeff Atwood) #2

What is an actual example of where one would want to do this?


Personally i find this really useful. Not to mention that this kind of static file, gives you way more opportunities to use your imagination, files, maybe other website service that you can run as static – etc :smiley:

(Mittineague) #4

I’m wondering what “stuff” limitations there are.

contents: |
       Stuff that's in the file goes here.

I imagine simple text strings work well enough, though I also imagine for this to be more useful, markup, links, images, etc. would be desired. I suspect that the more closely “stuff” approaches being a web page the more difficult it would be to not break.

@pfaffman what is your use case and what degree of complexity have you been able to do successfully?


An example that I just implemented was the ability to add ads.txt file, related to this (and similar to robots.txt:

You can see the example live here:

h/t for @pfaffman for the help!

(Jeff Atwood) #6

That’s already going to be folded into the ads plugin since it makes zero sense outside of that context.

(Felix Freiberger) #7

This can also help verifying ownership of the site, e.g. with Google Webmaster Tools :slight_smile:

(Michael - #8

Site ownership verification can be done with a meta tag in the head as well.

(Jay Pfaffman) #9

Well, you’ve seen the actual examples that I know about. There are ways not to need it, but I’ve wanted to do this a few times and finally bothered to figure it out. :slight_smile: