Divio Documentation#
Divio is a multi cloud infrastructure management service, with a platform for containerised web application deployment.
Divio aims to provide a better way to develop, deploy, scale and maintain web applications, and manage the infrastructure they run on, using workflows you’re familiar with and open-source tools you can trust.
Applications deployed on Divio can be created with any stack, platform or language.
They are containerised using Docker, versioned in Git and can be deployed to any one of multiple global cloud regions. Each application is provided with multiple environments (Test, Live, etc), with its own services (database, storage, backups, metrics, logging and more). Services are provisioned automatically for each environment.
For the convenience of developers, Divio includes comprehensive developer tools, and a powerful local development environment.
Quickstart#
Get started#
Tutorials. A hands-on introduction to Divio for developers.
TutorialsHow-to#
Step-by-step guides. Covers key tasks and operations and common problems.
How-toBackground#
Explanation. Clarification and discussion of key topics.
BackgroundReference#
Technical reference. Covers tools, components, commands and resources.
Reference
Additional resources#
Community#
The Divio Community is there to help you as well.
The Divio API#
The Divio API is a powerful tool for interacting with our infrastructure and your applications. See How to use the Divio API in this documentation and the Divio API reference documentation.
Speak to an expert#
Do you need to know more about Divio and its capabilities to decide whether the platform is suited to your most complex requirements? Get some answers from an expert, with no obligations and no sales-pitches - just the facts.
Our promises to developers#
Divio will help you achieve the results of an entire DevOps team all by yourself - there are just three steps to deployment heaven:
Docker: containerise your application using the world’s most popular containerisation technology.
Divio: create an application with the database, storage and other services it will need - all wired up and ready to go.
Deploy: go live, enjoying a fully automated build and launch.
If you let us take care of the dull, repetitive jobs, you’ll get to do the creative, enjoyable ones.
Index#
- Get started
- Installation
- Django
- 1. Create a new Django application
- 2. Set up your Divio application locally
- 3. Deploy your application to the Divio Cloud
- 4. Add and configure a Postgres database
- 5. Configure static file serving
- 6. Add and configure media storage
- 7. Apply some refinements
- Aldryn
- Wagtail
- 1. Create a new Wagtail Django application
- 2. Set up your Divio application locally
- 3. Make changes and deploy them
- 3.1. Add a new
home
application - 3.2. Deploy to the cloud
- 3.3. Using
divio app push/pull
- 3.4. Install a package from pip
- 3.5. More complex configuration
- 3.6. Where to go next?
- 3.1. Add a new
- Laravel
- How-to guides
- Get help and support
- Manage your account
- Manage your applications
- Configure an existing web application for deployment
- Configure an application (generic guide)
- Configure a Django application
- Configure a Flask application
- Configure a Gatsby application
- Create a new application
- Deploy an application
- Deploy your application to the Divio cloud platform
- Go-live checklist
- Development workflow
- Set up the Divio local development environment
- Run a local application in live configuration
- Configure external Git hosting
- Prepare the external Git repository
- Add the Git repository URL to the Control Panel
- Add your application’s public key to the Git host
- Test access
- Configure a webhook for the Git repository (recommended)
- Using the external Git remote
- Remote Git: Reset to origin
- Options and special cases
- Errors and what they mean
- Use Git to manage your application
- Set up CI/CD
- Use the Divio API
- Building a Docker application
- Platform-specific guides
- Install Python dependencies
- Create a multi-site Django application using Mirrors
- Configure Celery
- Force HTTPS with Express.js
- Add a Django application to an Aldryn application
- Configure Django settings using Aldryn
- Configure external logging
- Manage access authentication
- Manage redirects in Django applications
- Log in to a local Django application
- Manage uWSGI configuration
- Fine-tune uWSGI server performance
- Package an application as an Aldryn addon
- Update an existing Aldryn addon
- Managing an application’s resources
- Interact with your application’s database
- Interact with your application’s cloud media storage
- Configure media serving on a custom domain
- How to manage your application’s environment variables
- Additional information
- Upgrade a PostgreSQL service
- Troubleshooting
- Debug cloud deployment problems
- Debugging checklist
- Start here: a deployment has not worked as expected
- The Control Panel shows a Last deployment failed message
- Probable fault: temporary problem
- The deployment log contains no obvious error
- The runtime log contains no errors
- The runtime log contains errors
- The deployment log contains an error
Client application error: unable to connect to the application
Could not find a version that matches [...]
npm ERR! [...] ERR! /npm-debug.log
ReadTimeoutError
- The environment does not show a “Last deployment failed” error
- Decision tree
- Debugging checklist
- Diagnose performance issues
- Identify and resolve a Python dependency conflict
- Get help when you have a problem
- Debug cloud deployment problems
- Technical reference
- Divio software components
- Divio infrastructure
- Docker configuration
- Coding in Divio applications
- Applications
- Policies
- Plans and pricing
- Quick reference
- Aldryn Django addons (legacy)
- Addon configuration with
aldryn_config.py
settings.py
in Aldryn Django- Key addons
- Aldryn Django (core Django)
- Aldryn SSO (authentication)
- Aldryn Addons (addon integration)
- Addon configuration with
- Background information
- Cloud management
- Our infrastructure
- How it works on Divio
- Applications
- Recommended application configurations
- Aldryn Django and addons (legacy)