Getting Started

So you just installed OBM, congratulations! Now, what next?
The following assumes that you installed all OBM components on the same machine (e.g., by installing the *obm-full* package).

### Connecting to your new OBM instance
* Open a browser to **https://**. You should come up with something like this:

* Enter login **admin0**
* Enter password **admin**
* Press *Enter* or click *Submit*
* You're now logged in as user *admin0* and you can start configuring your OBM instance.

### Create your first Host
* Got to *Users* (top menu) > *Hosts*.
* Click *New* to create a host. You should see something like this:

* Type **Local** in the *Name* field.
* Type **127.0.0.1** in the *IP* field.
* Type **local.global.virt** in the *Fully qualified name* field (the fully qualified name is simply *[name].[domain name]* in lowercase).
* Tick the following check boxes: *IMAP*, *SMTP In*, *SMTP Out*, *IMAP Frontend*, *OBM Sync*, *Solr*; *LDAP* and *Monitoring*.
* **New in 3.1.0** : Tick the new Imap Archive to use the new module ([more detail](http://docs.obm.org/obm-imap-archive/gettingStarted.html)).

This screenshot shows the host creation form with all fields set:

* Click *Create*.

### Create your first Domain
* Go to *Administration* > *Domains*.
* Click *New* to create a domain. You should see something like this:

* Type **local.global.virt** in the *Label* field.
* Type **local.global.virt** in the *Description* field.
* Type **local.global.virt** in the *Domain Name* field.
* Select the **Local** host in the following locations: *SMTP Out*, *IMAP*, *SMTP In*, *IMAP Frontend Servers*, *OBM Sync*, *Indexing Servers* and *LDAP*. This screenshot shows the host creation form with all fields set:

* Click *Insert Domain*.

### Create an administrator user for the domain
* Go to *Users* > *Users*.
* Click *New* to create a new user. You should see something like:

* Enter **Admin** in the *Last Name* field.
* Enter **admin** in the *Login* field.
* Choose a password and enter in in the *Password* field or use the *Generate* button to generate one.
* Select **obm.domain** as the *Domain*.
* Select **admin** as the user *Profile*.
* Check the *Mail* check box in the *Mail* section.
* Enter **admin** as the email address. The complete email address will be admin@[domain name].
* Click *Insert User*.

### Apply the modifications
Now that you made various modifications to your configuration, you need to apply them it so that all OBM components are synchronized.
OBM warns you about a required update by displaying the "*Yellow Pill*", a round, yellow button with an exclamation mark (!) located in the top-right part of the screen.

* Click the *Yellow Pill*. You should see something like:

* Click the *Validate* button of the *Global Domain* section. Wait for the process to complete.
* Click the *Validate* button of the *obm.domain* section. Wait for the process to complete.
* Once the update is complete, you should come up with something like this:

* Click *Logout* (the link is located in the profile menu, right part of the top menu bar) to end your session with the *admin0* user.

### Login with your newly created user
* You should be back to the front page.
* Enter login **admin**.
* Enter the password you chose.
* Make sure **obm.domain** is the selected *Domain*.
* Click *Submit* button

### Start a healthcheck
Since OBM 2.5, OBM got a Health Check system, which ensures that an OBM installation is operational. Please follow this documentation about the [healthcheck](obm-health-check-system).

Congratulations, you're now ready to use OBM!Boots