First, choose a name. In this tutorial we’ll use example which will be example.usegalaxy.eu, with a brand of “Example”. Remember to change as appropriate for your name.

Galaxy Configuration

  1. Add your site. It should look something like:

     - name: example
       brand: Example

    Name is an id used in creation of several filenames internally and in the website repository. It should match [a-z]+

  2. Make a PR with these changes

In the website repository:

  1. Create an index page like this one in the website repository. Above we specified that name: example, so you should create index-example.md in the root of the website repository.
  2. Make a PR with these changes

DNS Changes

  1. Add your domain to this list under subdomain, and increase the count parameter below by one.
  2. Make a PR with these changes.

Customizing Tools

  1. Edit global_host_filter.py, you’ll want to edit both functions to define appropriate values for your galaxy subdomain.

How it works internally

There is a nginx location directive that redirects the front page request from the subdomain/welcome.html to the file /opt/multisite-css/$host.html, hosted locally into the Galaxy server.

This mechanism rely on the default value of the welcome_url variable in the Galaxy configuration. If you change it, then you have to modify the nginx location directive accordingly.