1. Get started¶

    1.2. Install the Divio CLI package¶

    The is installable using pip:

    If you already have it installed, check that it is up-to-date:

    You can install this in a virtualenv if you prefer not to install it globally.

    Important

    You will also need to install the Aldryn Client package (a future updatewill make this unnecessary):

    divio-cli needs to be authenticated with the Control Panel in order tointeract with it:

    This will open your browser athttps://control.divio.com/account/desktop-app/access-token/, where you can copyan access token to paste into the prompt:

    1.4. Add your public SSH key to the Control Panel¶

    Note

    Note sure how to manage SSH keys?

    See the excellent GitHub articles on how to connect with SSH.

    At this stage, you have two ways to set up Docker. You can either do it byhand, or use the to manage this for you.

    We recommend using the Divio app, which is available for Macintosh, Linux andWindows. (It’s especially recommended if you are using a version of Windowsother than Windows 10 Professional.)

    If you prefer to do it by hand, see Set up Docker by hand below.

    and install it. Whenyou run it, it will take care of installing and setting up Docker.

    1.6. Set up Docker by hand¶

    Important

    We recommend that you allow the Divio app to manage installation and configuration.

    Consider a manual installation only if you already know what you are doing!

    • Download and install or Docker for Windows.
    • Check that it runs correctly and that the Divio app is able to communicate with it.

    Note

    Older versions of macOS and Windows do not support the native Dockerapplication. Instead, they require Docker to be run in a virtual machine(in VirtualBox) and the Docker Toolbox application provides a set of toolsto interact with it.

    This can be more difficult to set up than Docker for Windows, but the Divioapp will take care of it. This is the strongly recommended way to set upDocker in such a case.