04 Create a Rancher Environment

This page details how to create an environment inside a running instance of Rancher server.
An environment uses one or more registered hosts (Docker hosts, aka Rancher agents) to run Docker containers. An environment groups stacks, which are composed of services, which are made out of one or more containers.

More information can be found here.

1. Go to Rancher UI

2. Go to top left menu entry → Manage Environments

3. Click the "Add Environment" button
   

4. Fill in the fields

   1. Name: tgd
   2. Description: Used by Java Tech Group Day #5 Rancher workshop
   3. Environment Template: Cattle
   4. Access Control: use your user account as owner for this new environment

   

5. Click "Create" button to have Rancher create this environment

6. Make the newly created environment the default one by going to environment menu → Set as Default
   

7. Switch to the newly created environment by going to environment menu → Switch to this Environment
   

8. The newly environment is empty: it hosts no stacks, it has no registered hosts
   

9. Optionally, you can delete "Default" Rancher environment, if you no longer use it