Warning

This repository is no longer maintained by our internal teams.
The template is provided as is and will not receive updates, bug fixes, or new features.
You are welcome to contribute on it or fork the repository and modify it for your own use. To deploy this template on Upsun, you can use the command upsun project:convert on this codebase to convert the existing .platform.app.yaml configuration file to the Upsun Flex format.

Wagtail for Platform.sh

This template builds the Wagtail CMS on Platform.sh, using the gunicorn application runner. It includes a PostgreSQL database that is configured automatically, and a basic demonstration app that shows how to use it. It is intended for you to use as a starting point and modify for your own needs. You will need to run the command line installation process by logging into the project over SSH after the first deploy.

Wagtail is a web CMS built using the Django framework for Python.

Features

• Python 3.11
• PostgreSQL 12
• Automatic TLS certificates
• Pipenv-based build

Post-installation

After installation, you will need to create the initial administrative user.

1. SSH into the project using platform ssh (if you have checked out a copy of the repository), or using the SSH login URL provided in the web console.

2. Run:

pipenv run python manage.py createsuperuser

That will create the initial user and provide you with the admin password.

3. Login to the Wagtail admin section at the /admin URL for your project.

Customizations

The following files have been added to a basic Django configuration. If using this project as a reference for your own existing project, replicate the changes below to your project.

• The .platform.app.yaml, .platform/services.yaml, and .platform/routes.yaml files have been added. These provide Platform.sh-specific configuration and are present in all projects on Platform.sh. You may customize them as you see fit.
• A starter application myapp is included for demonstration purposes - the same application generated with the Wagtail getting started command wagtail start myapp - with a few Platform.sh-specific changes. In particular, the myapp/settings/dev.py file is set up to configure Django to connect to the correct database, and to run a production server (DEBUG = False). You are free to change that configuration if you prefer.

References

• Wagtail
• Python on Platform.sh