dsd-scalingo

A plugin for deploying Django projects to Scalingo, using django-simple-deploy.

For full documentation, see the documentation for django-simple-deploy.

Current status

This plugin is in a pre-1.0 development phase. Scalingo has one of the best free trial plans in the industry, so this plugin will be prioritized and should move forward quickly.

Prerequisites

• You need to be using Git for version control, and your project needs to start with a clean status (no uncommitted changes).
• You need to have a requirements.txt file. Deployment should also work if you're using Poetry or Pipenv. If you're using uv, you can generate a requirements.txt file and then run the deploy command as described below.
• You need an active account on Scalingo.

Configuration-only deployment

In this mode, django-simple-deploy handles all the configuration work, but lets you create the remote Scalingo app, commit changes that are made, and run the push command yourself.

• Install the Scalingo CLI.
• Upload your SSH public key to Scalingo.
• Run the following commands to install the plugin, and create a remote Scalingo app:

$ pip install dsd-scalingo
# Add django_simple_deploy to INSTALLED_APPS.
$ scalingo login
$ scalingo create <scalingo-app-name>

Now review the changes that were made, and then push your project:

$ git add .
$ git commit -m "Configured for deployment to Scalingo."
$ git push scalingo main
$ scalingo open

Your deployed project should appear in a new browser tab.

Fully automated deployment

• Install the Scalingo CLI.
• Upload your SSH public key to Scalingo.
• Run the following commands:

$ scalingo login
$ pip install dsd-scalingo
# Add django_simple_deploy to INSTALLED_APPS.
$ python manage.py deploy --automate-all

Your deployed project should appear in a new browser tab.

Destroying a project

If you're doing a test deployment and want to destroy your project:

$ scalingo --app <app-name> destroy

You can also destroy projects through the Scalingo dashboard.

Scalingo documentation

These have been the most helpful parts of the Scalingo docs so far:

• Python on Scalingo
• Get started with Django on Scalingo
• CLI reference
• Environment variables
• First steps/ SSH key setup
• Postgres on Scalingo