Divio App Required  Divio Shell Required

In this short guide we will show you how to set up a Wagtail Project on Divio Cloud.

Create the project

Login to the Control Panel.

Select Add new Project.

This will redirect you to the "Add new Project" creation screen. In addition to choosing a Name for your project, the following options are required to get started with the guide:

  • Creation: New
  • Region: Choose United States or European Union
  • Python: Python 3.x
  • Type: Wagtail
  • Boilerplates: Blank Boilerplate

Click Create Project and continue to the Project’s Dashboard.

Manage the installed addons

Check Aldryn Django is on version 1.11 or newer

Our standard Wagtail is version 2.x. Wagtail 2.x requires at least Django 1.11, so you will need to ensure the version of the Aldryn Django addon is set appropriately:

  • Select Addons from the menu at the left.
  • Select Aldryn Django from the list of addons.
  • If it's not already on version 1.11 or newer, update it.

Install the Wagtail Home addon

In a new Wagtail project, you need to create your first application. We've provided one already in Wagtail Home, based on the one described in the official Wagtail documentation.

  • Find Wagtail Home in the list of addons.
  • Install it.


In the Dashboard, Deploy the project's Test server. In a minute or two, your site will be deployed and ready to explore. See the Wagtail introductory documentation for more on using Wagtail.

Set up and run the project locally

Install and launch the Divio App

Select your project and 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.

Once this process has completed, you can actually start the local site by getting the local server running. Select Start to launch it. To open the local site in your browser, click the eye icon.

This will open your project in your default browser. You should see the Wagtail welcome page.

Add a new Wagtail page

Login to the Django admin at /django-admin in the local site. Create a new user by hitting Add user and then sign in. (Learn more about how this works.)

In the Wagtail admin at /admin/pages , add a new page by clicking Add Child Page:

Add a title and some content and press "Publish"

Now set the page as a root page in the Wagtail admin by going to Settings > Sites > localhost. Select the localhost site. 

In the Root Page row select Choose a different Root Page and find the new sub-page of it that we just created:

Hit Save to continue.

Finally, go to your site - In the Wagtail Explorer, find your page and hit the Live button to see the published page.

Next steps

You've now created a new Django Wagtail site on Divio Cloud, configured its addons, deployed it locally in the Divio Shell, and started editing it. 

The next steps are to explore our local development environment, in which you can create your own new functionality, and publish the site on the web, using the Divio Cloud.

Our developer documentation will tell you more. 

See also our guide to using the Divio app.

Django/Wagtail versions

  • Aldryn Wagtail 2.1 or later requires Aldryn Django 2.0 or later
  • Aldryn Wagtail 2.0 or earlier requires Aldryn Django 1.11 or earlier
Did this answer your question?