h1. *+THIS PAGE IS OUT OF DATE. PLEASE REFER TO THE "FOREMAN MANUAL":https://theforeman.org/manuals/latest/index.html+*

h1. Locations and organizations

h2. Summary

The Foreman supports locations and organizations for managing different resources inside of a single instance and granting users specific access to those resources, including hosts, hostgroups, domains, subnets, and compute resources, environments, and others. Locations and organiztions can be enabled independently of one other; for example if your installation only requires locations then there is no need to have organizations on.

h2. The basics

Locations and/or organizations are disabled by default, but can be enabled by setting the following values in config/settings.yml:

<pre>

:locations_enabled: true

:organizations_enabled: true

</pre>

You should restart Foreman after changing these values. Additionally, the "login" setting must be set to true to use locations & orgs. 

h2. Setting up locations & orgs

Once you've enabled locations or organizations and set login to true you will see new menu items:

!http://i.imgur.com/qHZ0nwRl.jpg!

Select either locations or organizations to create new ones. For example, choosing to create a new location will bring you to a basic creation form. Name the new location or org and submit it. Next, edit the object you just created; on this page you will be able to select different resources from throughout Foreman to add to a location or org:

!http://i.imgur.com/nvX1uUEl.jpg!

Submit the form once you've added all the resources that are needed for a single org or location. Next, you can add a host to an organization or location, only locations or organizations without the proper resources based on the host's current settings will be excluded from the list of available locations and/or organizations:

!http://i.imgur.com/eBQ1KQq.png!

h2. Usage

There is a gravatar on each page and clicking on the image next to it will allow you to switch into a specific context based on either a location/organization or combination of the two:

!http://i.imgur.com/7BwE2GRl.jpg!