Mist

Mist is an open source multicloud management platform. It provides a unified interface for controlling your resources across more than 20 public clouds, private clouds, hypervisors, container hosts and bare metal servers. Mist also offers a RESTful API and a CLI so you can easily integrate it into your existing workflows. For more information check out https://mist.io.

Software Included

Creating an App using the Control Panel

Click the Deploy to DigitalOcean button to create a Droplet based on this 1-Click App. If you aren’t logged in, this link will prompt you to log in with your DigitalOcean account.

Creating an App using the API

In addition to creating a Droplet from the Mist 1-Click App using the control panel, you can also use the DigitalOcean API. As an example, to create a 4GB Mist Droplet in the SFO2 region, you can use the following curl command. You need to either save your API access token) to an environment variable or substitute it in the command below.

curl -X POST -H 'Content-Type: application/json' \
         -H 'Authorization: Bearer '$TOKEN'' -d \
        '{"name":"choose_a_name","region":"sfo2","size":"s-2vcpu-4gb","image": "mistio-mist-20-04"}' \
        "https://api.digitalocean.com/v2/droplets"

Getting Started After Deploying Mist

Once your Droplet is ready you need to create an admin user. To do this:

1. Connect to your Droplet over SSH with ssh root@your_droplet_public_ipv4.
2. Go to the Mist folder with cd /mist.
3. Wait until all Mist containers are up. This normally happens a couple of minutes after boot. You can check the status with docker-compose ps.
4. Once all containers are up, run docker-compose exec api sh. This will drop you in the shell of a Mist container.
5. In the shell, do ./bin/adduser --admin [email protected]. This will prompt you to enter a password.
6. Everything is now ready. Visit http://your_droplet_public_ipv4:80 and login with the email and password you specified above.

By default, new users will not be able to create an account through the sign up form. We turn this off for security reasons. If you would like to enable it, edit ./settings/settings.py and set ALLOW_SIGNUP_EMAIL to True. Then restart Mist with docker-compose restart.

If you would like to use a custom domain for your Mist installation, you will need to update Mist’s CORE_URI. For more details check out https://github.com/mistio/mist-ce#url

In some cases, such as user registration, forgotten passwords, user invitations etc, Mist needs to send emails. By default, Mist is configured to use a mock mailer. For more information about mail mock and how to setup Mist with your existing email server, check out https://github.com/mistio/mist-ce#mail-settings.

Finally, it is strongly recommended to enable TLS. Here is how you can do it https://github.com/mistio/mist-ce#tls-settings.