FinalDivvyCloud

Linux Test Drive Deployment

This document explains how to deploy DivvyCloud quickly and simply for evaluation purposes using Docker Compose. If you install DivvyCloud locally, it should take less than 15 minutes to get up and running.

Quickstart Installation

To simplify installation you can run this script which will install docker & docker-compose if they are not installed, pull down the DivvyCloud docker image and run our standard compose file.

curl -s https://s3.amazonaws.com/get.divvycloud.com/index.html | bash

# Will automatically run in the foreground. Exit with ``Ctrl-C``

If you would like to install Docker community edition and docker-compose on your own, follow the instructions below. Otherwise, continue with Logging into DivvyCloud.

Install Docker and Docker-Compose

First, you need to install Docker Community Edition and Docker Compose.

Next, add the following docker-compose.yml file to your present working directory:

curl -sO https://s3.amazonaws.com/get.divvycloud.com/compose/prod.env
curl -s https://s3.amazonaws.com/get.divvycloud.com/compose/docker-compose.db-local.yml -o docker-compose.yml

Start DivvyCloud with Docker Compose

Now you are ready to start DivvyCloud. To run in the foreground and see logging information in your terminal, use:

docker-compose up

or to run in the background, use:

docker-compose up -d

Logging into DivvyCloud

After DivvyCloud has completed its launch, you can connect via browser using port 8001, e.g., http://localhost:8001.

The first page you see is an administrator account creation page. On the page, you enter your name and email address and create a userid and password. Your userid can be any alphanumeric. Your password must be at least 12 characters in length.

Next, you login with the administrator account credentials you just created.

Stop DivvyCloud with Docker Compose

When your evaluation is over (and we hope you enjoyed it) and you’re ready to stop, use:

docker-compose down

# Exit with ``Ctrl-C`` if running in foreground

Running docker-compose on Instance Boot

You can have DivvyCloud start on instance boot using crontab, but instead of using a time interval, use @reboot. In order to do so, switch to the user who will start docker-compose, enter the command crontab -e to open the crontab editor and add the following line:

@reboot /<path-to>/docker-compose -f /<path-to>/divvycloud/docker-compose.yml up -d

Recommended Linux Distributions

If you are not installing DivvyCloud locally, please see our Server and Network Recommendations .

Using a Proxy Server

If you wish to use a proxy server for your Test Drive, you will need to add your proxy information to your:

1.System’s environment variables before your installation and
2. DivvyCloud environment variables after your installation