OA Domains (oa_domains) is a submodule that comes with the Open Atrium distribution, it adds the ability to have a separate URL domain for each Space in Open Atrium. This page will show you how to configure OA Domains properly, it's characteristics and limitations.

OA Domains will change the URL for each Space that has a custom domain name from example.com/myspace to myspace.example.com. Sections will be displayed as myspace.example.com/mysection.

If you set one space to "domain1.com" and another space to "domain2.com". They would be sharing the exact same code and database. Since Spaces allow you to set membership and control content, this will act very much like a multi-site or micro-site.

Setting things up

• Enable the oa_domains submodule
• Set a base domain at admin/openatrium/setting, e.g. example.com
• Create one or more Spaces, and at the Space creation page fill in a custom domain name for the space, e.g. myspace.example.com. Do not include the http://
• Clear cache in each subdomain, you need to log in again for each subdomain

You have to make sure your domain's DNS Zone Record has the correct settings and points to each subdomain correctly. Pantheon has some articles about setting up a domain for Gandi and Godaddy. For Pantheon you need to set an "A" record (and an AAAA record) with the ip address of your live site for the base domain, and a CNAME for each subdomain (Space) each pointing to live-yourdomain.pantheon.io. You find the correct ip addresses at your Pantheon Dashboard.

You may see some pages displayed without the proper theme, this is why you have to clear cache. It is still possible to find the right place in the forms to set the custom domain name. Visit each Space under it's new domain and clear cache. Eventually the theme should display normally.

You can customise the site name (which appears on your browser tabs in the format [node:title] | [site:name]) for each domain by clicking the "gear" on the top right-hand side and selecting "Config" for each space. There you can edit the Site Name for each Space under "Variables". You will also need to set the homepage for each Space, to do this first add the Default front page variable (at configuration - organic groups - OG variables admin/config/group/variable), then for each domain/Space change the variable to reflect the page you want to use as homepage (most likely the top level Space itself).

Since all Spaces share the same database it is not possible to completely separate the users for each Space. See an issue about this.