1. Get started¶
1.1. Create your account¶
A Divio Cloud account is free to set up and use indefinitely. Create your account on the Divio Cloud Control Panel, or log in there if you already have one.
Our Divio GUI application can set up all you need to get started. In this tutorial however we will install and configure the components - Docker, the Divio CLI, and so on - manually. This will give more experienced developers a better insight into the system and how it all works together.
We expect you to have pip and Git installed and to have at least a basic understanding of their usage.
Older versions of Macintosh OS X and Windows
Older versions of Macintosh OS X and Windows do not support the native Docker application. Instead, they require Docker to be run in a virtual machine (in VirtualBox) while the Docker Toolbox application provides a set of tools to interact with it.
This can be more difficult to set up than Docker running natively, but the Divio app will take care of it. This is the strongly recommended way to set up Docker in such a case.
If you’re using one of these older systems and cannot upgrade, please download and run the Divio app. With some fairly minor differences, you’ll be able to follow this tutorial using the Divio Shell that the app provides.
Download the Divio application and install it. When you run it, it will take care of installing and setting up Docker the components you require.
Continue at Set up a new project.
1.2. Install the Divio CLI package¶
The Divio CLI application is installable using pip (along with the aldryn-client package that is required for some local operations):
pip install divio-cli aldryn-client
If you already have them installed, check that they are up-to-date:
pip install --upgrade divio-cli aldryn-client
You can install this in a virtualenv if you prefer not to install them globally.
1.3. Log in¶
divio-cli needs to be authenticated with the Control Panel in order to interact with it:
This will open your browser at https://control.divio.com/account/desktop-app/access-token/, where you can copy an access token to paste into the prompt:
➜ ~ divio login Your browser has been opened to visit: https://control.divio.com/account/desktop-app/access-token/ Please copy the access token and paste it here: rsYa1d0qDyF6TbI4wzfrdfSKinqSWAoxU7NgN7Cssgg5ndFfk3naghagh7 Welcome to Divio Cloud. You are now logged in.
1.4. Add your public SSH key to the Control Panel¶
The Control Panel needs your public key, so that you can interact with our Git server and so on. Visit SSH Keys in the Control Panel. Add your public key.
Note sure how to manage SSH keys?
See the excellent GitHub articles on how to connect with SSH.
1.5. Set up Docker¶
Launch Docker. Check that it’s running correctly with:
docker run --rm busybox true
1.5.1. Checklist for Docker installation on Windows¶
- In Docker’s settings, make sure that it is set to use Linux containers.
- Ensure that your Windows user is in the docker-users group.
- When you launch Docker, make sure that you do so as a Windows administrator.