Django on HelioHost
About Django
Django is a web development framework designed specifically for Python. As Ruby on Rails does for Ruby, Django aims to provide an MVC (Model-View-Controller) architecture for web application development as well as a large set of prebuilt libraries to simplify the development of common web app features. Django's modularity also allows easy scalability and enables the reuse of various code blocks, aligning to the DRY ("Don't Repeat Yourself") software development principle.
Django on the Johnny server uses Python 3.12
If you need to run Django on another version of Python, you'll need to get a VPS.
Server | Django Version | Python Version | Python Modules Installed | Python Path | Loader |
---|---|---|---|---|---|
Johnny | 5.0.7 | 3.12 | /usr/bin/python3.12 | WSGI |
Django on the Tommy server uses Python 3.10
If you need to run Django on another version of Python, you'll need to get a VPS.
Server | Django Version | Python Version | Python Modules Installed | Python Path | Loader |
---|---|---|---|---|---|
Tommy | 4.1.1 | 3.10 | /usr/bin/python3.10 | WSGI |
Enabled
WSGI
Using the WSGI loader for a shared hosting environment is ideal because it conserves memory and enhances security.
Django changes can take up to 2 hours to appear consistently on your site because WSGI uses server side caching.
If you want site changes to take effect immediately, we offer a few options to work around caching.
Complete Django
We offer the complete, unadulterated Django package, including extensions to interface with MySQL, PostgreSQL, and SQLite database engines.
Additional Libraries
View the Python modules installed on Johnny. View the Python modules installed on Tommy.
To request additional libraries, please raise a request in the Customer Service forum, making sure to provide your username, your server, and the libraries you need including any relevant version numbers for them.
Disabled
Shell Access
We don't offer shell (command line) access to our users. Many Django tutorials and installation instructions assume that users have command line access, which may make working with Python & Django more difficult. Most people tend to develop on their home computer and then upload to their web server, which almost negates the need for this feature. Furthermore, most configuration done through the command line can be done through other methods, such as FTP and manual file editing.
WSGI Daemon Mode
There are two ways to configure Django to work with the mod_wsgi loader in Apache. You can either create a separate daemon for each Django process (daemon mode) or embed Django into the Apache daemon (embedded mode). While daemon mode tends to be the standard among Django admins because of the increased control it offers, we use embedded mode because it can be set up on a per-user basis without very much root-level configuration. Embedded mode is slightly harder to get working (see directions below), and might break compatibility with some Django tutorials. In most cases, it should not be a problem.
Getting started with Django on HelioHost
This brief tutorial will guide you through setting up a Django test app without using the command line on your development system.
If you already have an existing Django app or prefer to use the command line, our tutorial on Converting an Existing Django App may better suit your needs.
1. Create a directory on your main domain called djangotest
.
djangotest
.If you were transferred from the old cPanel, your main domain will be parked on the public_html
directory.
If you created a new account on Plesk, your directory will be httpdocs
.
2. Create an .htaccess
file inside the djangotest
directory with these contents:
.htaccess
file inside the djangotest
directory with these contents:3. Create another djangotest
directory within the first djangotest
directory
djangotest
directory within the first djangotest
directoryThis directory structure is standard for a Django project. Please note that you cannot name the project folder django
, it will not work. This is why the name djangotest
is being used in this example.
4. Create a dispatch.wsgi
file inside the second djangotest
directory with these contents:
dispatch.wsgi
file inside the second djangotest
directory with these contents:Make sure you edit the path:
On Plesk, your path is /home/domain.helioho.st/httpdocs/djangotest
.
If you were transferred from cPanel, your path is /home/domain.helioho.st/public_html/djangotest
.
5. Create a __init__.py
file inside the second djangotest
directory
__init__.py
file inside the second djangotest
directoryThis file should remain empty.
6. Create a urls.py
file inside the second djangotest
directory with these contents:
urls.py
file inside the second djangotest
directory with these contents:7. Create a settings.py
file inside the second djangotest
directory with these contents:
settings.py
file inside the second djangotest
directory with these contents:8. Make sure your directory structure and files look like this:
9. Visit Your Site
In your web browser, navigate to domain.helioho.st/djangotest
If you did everything right it should look like this:
WSGI Uses Server Side Caching
What WSGI Server Side Caching Does
Multiple Apache processes are running on the server, and each time you refresh your site you are randomly assigned to one of these processes. If that particular process has already displayed your site, it shows the cached version of your code; otherwise, it shows the new code changes. This means that during the first 2 hours after a site change, you may intermittently see old or new content, depending on which process you get assigned to. This situation will resolve when Apache is restarted, which happens every 2 hours.
Options to Work Around Caching
1. Request WSGI Control Access
A new feature currently in beta is the ability for users to restart their Django app themselves.
To request this, please create a new post in the Customer Service forum and provide your username, server name, and the domain name(s) you want to be given WSGI Control Access for. (If you have 2 Django apps on 2 different domains, you need to request WSGI Control Access for each domain.)
Once you have been given WSGI Control Access, you can edit your dispatch.wsgi
to reload your Django app so new code changes load immediately. The edits to the file can be as simple as adding or removing a space or a blank line. As long as the file's last modified date
changes it will discard the cache and reload your Django app.
Please let us know if you experience unexpected results with this new feature.
Account Resets Remove WSGI Control Access
If you request an account reset you will need to re-request WSGI Control Access after the reset has been completed. By default, account resets will disable WSGI Control Access.
2. Use Local Development Environment
Another option to see code changes reflected immediately is to develop your Django app on your home computer and then host the production copy on the server.
3. VPS
You may prefer to explore one of our paid VPS Plan options, depending on your requirements.
References
This tutorial is adapted from this post.
Last updated