Installing USM
--------------

USM is only tested and verified to work on Ubuntu 12.04 and above and can be downloaded from [their website](http://www.ubuntu.com/download/desktop). Support for other operating systems would be a nice feature but is not planned in the immediate future. It should be also be able to work on earlier versions of Ubuntu or really any other Debian based system, but this has not been tested at all. The rest of the installation will assume you are using Ubuntu 12.04.

After installing your operating system, please open up a Terminal. In Ubuntu, this can be done by going to your Dash Home.

![Dash Home](etc/img/usm-dash-home.png)

Then, type in 'terminal' and click the first icon.

![Open Terminal](etc/img/usm-open-terminal.png)

At the prompt, please copy and paste the following code and press enter.

    wget https://bitbucket.org/ykuzma1/usm/downloads/usm-1.1.zip
    unzip usm-1.1.zip && cd usm-1.1
    sudo bash install.sh install

Breaking it down, the first line downloads the entire USM source package. It then is uncompressed and opened. Finally, it runs the USM installer script. Following the directions given in the script, you will be prompted to create an administration account as well as provide you host name. This host name is generally in the form of 'example.com', and if unknown, can likely be given to you by your System Administrator.

![Admin Hostname](etc/img/usm-admin-hostname.png)

The rest of the output should appear as follows.

![USM Installer](etc/img/usm-installer.png)

And that's it! You can now open up a browser and enter either 'localhost' or your public domain name for the url. Notice how the installer ended with instructions to modify USM's configuration. This *is not* necessary if you are running USM by itself on a freshly installed system (99% of use cases). Otherwise, you most likely have a good amount of unix experience. You are on your own for the most part, but I would recommend looking at the 'install.sh' script and running the commands manually as needed.

If there are any immediate problems such as not being able to login with your administration account or blank screens during login, please upload your installation log file to our forum. This is located at '/tmp/usm-install.log'. To make it appear on your desktop, please run the following command in a Terminal.

    sudo cp /tmp/usm-install.log ~/Desktop/.