We know everyone has their favourite tools for editing CSS, JavaScript and images, and their preferred ways of working. Divio Cloud lets you work the way you're most comfortable, using your computer and your tools to manage your static files.

The Divio app is available for Macintosh, Linux and Windows.

The Divio app lets you:

  • manage (create, deploy, publish, share) your projects
  • run your project locally in a Docker container, for development and testing
  • set up a shell environment ready for interaction with the project running in the Docker container

Getting started


The Divio App here.


Open the downloaded package and follow the on-screen instructions to install the application.

Info: Some anti-virus software for Windows may warn that the Divio App application is unsigned and therefore represents a security risk. You can safely ignore this warming.


Once the application is installed and running you can login using your email address and password, or simply copy the access token from the Divio Control Panel and paste it into the field in the client.

Workspace folder

Select a workspace folder (a folder on your computer where you’d like to keep all the Divio Cloud project files), then select Continue.

Working with the Test Server

Select a project to work with from the list on the left. By default, the list shows All projects, but you can narrow down the selection by choosing a particular organisation from the dropdown menu.

Use the Test Server pane to deploy your Test Server in the Divio Cloud - just as if you were using the Control Panel itself.

The Test Server pane gives also you quick access to your test site and to the project's Dashboard in the Control Panel.

Working with a local project

The Local Server pane manages the local version of the project, which runs in a Docker environment exactly matching that in the Test Server.

Set up your local project

  • Select the project from the list.
  • Hit Setup to get started.

The Divio App will run through a number of processes to set up the local project. It all happens automatically and takes just a few minutes.

Launch the site locally

Once this process has completed, you can actually start the local site by getting the local server running. 

  • Select Start to launch the project.
  • Open the local site in your browser by clicking the eye icon.

Edit project files

  • Hit to the Folder icon to open the project:

Upload/download changes

If you've previously used the Auto-sync feature, try this.

  • Use the Upload and Download buttons to push your changes to the Cloud (and pull down any new changes).

You can also Upload and Download the project's media files and database.


There are some additional options alongside Setup. They are:

  • Update: pull down any changes from the Test Server
  • Rebuild: rebuilds the project from the local files
  • Reset: tear down the project and start again

Interact with the project

You can interact with the project directly in a shell in its container.  

  • Open the project's bash shell by clicking the shell icon.

Launch the Divio Shell

As well as a bash shell specific to each project, the Divio app can set up a general shell that is configured to interact with the Divio Cloud. It runs in a Docker container of its own.

In this Divio Shell, you can also run Divio CLI commands, such as divio project list .

You cannot interact directly with project containers in the Divio Shell. Instead, you should cd  into the project directory locally, and precede your commands with docker-compose run web , for example:

docker-compose run web python manage.py

To use the Divio Shell, hit Open Shell in the Divio app, and in a few moments you'll be in a terminal shell session:

Distinction between the Divio Shell and the Local Container bash shell:

  • the Divio Shell is for managing local projects and interacting with the Divio Cloud
  • the Local Container bash shell is for operations inside local projects 

Further resources

Did this answer your question?