DivvyCloud Test Drive Deployment for Linux¶
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.
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¶
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:
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.
When you first log in, you are on the ‘Dashboard’. There is a ‘Setup Checklist’ that guides you on useful first steps, specifically:
- Connecting a cloud account
- Adding an Insight
- Creating a Bot
- Connecting your email
- Adding an integration, e.g., Slack
After you have completed some or all of the checklist, we recommend that you examine your cloud infrastructure from the Resources section and start to explore.
You can try any of the 200+ filters available to inspect your infrastructure for specific items of interest. You can layer filters to further refine your focus.
Or, perhaps easier, look at the Insights section to see popular filters and filter combinations that are organized by category, e.g., security, cost optimization, etc.
You can try different Insights, customize them as you see fit, save them for reuse, and use them to create ‘one-click’ Bot templates that enable automated action to enforce policy, whether security or cost management.
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
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 recommendations.