Deploying a Django project on PythonAnywhere is a lot like running a Django project on your own PC. You'll use a virtualenv, just like you probably do on your own PC, you'll have a copy of your code on PythonAnywhere which you can edit and browse and commit to version control.
The main thing that's different is that, instead of using the Django dev server
manage.py runserver and viewing your site on localhost, you'll create
what we call a Web app via the Web tab in our UI, and then configure it with
a WSGI file whose job is simply to import your Django project.
And then your site will be live on the real, public Internet. woo!
Here's an overview of the steps involved.
- Upload your code to PythonAnywhere
- Set up a virtualenv and install Django and any other requirements
- Set up your web app using the manual config option
- Add any other setup (static files, environment variables etc)
Uploading your code to PythonAnywhere
Assuming your code is already on a code sharing site like GitHub or Bitbucket, you can just clone it from a Bash Console:
# for example $ git clone https://github.com/myusername/myproject.git
That's the solution we recommend, but there are a few different methods documented on the uploading and downloading files help page.
Create a virtualenv and install Django and any other requirements
In your Bash console, create a virtualenv, naming it after your project, and choosing the version of Python you want to use:
$ mkvirtualenv --python=/usr/bin/python3.4 mysite-virtualenv (mysite-virtualenv)$ pip install django # or, if you have a requirements.txt: (mysite-virtualenv)$ pip install -r requirements.txt
Warning: Django may take a long time to install. PythonAnywhere has very fast internet, but the filesystem access can be slow, and Django creates a lot of small files during its installation. Thankfully you only have to do it once!
TIP: if you see an error saying
mkvirtualenv: command not found, check out InstallingVirtualenvWrapper.
Setting up your Web app and WSGI file
At this point, you need to be armed with 3 pieces of information:
- The path to your Django project's top folder -- the folder that contains "manage.py", eg /home/myusername/mysite
- The name of your project (that's the name of the folder that contains your settings.py), eg mysite
- The name of your virtualenv, eg mysite-virtualenv
Create a Web app with Manual Config
Head over to the Web tab and create a new web app, choosing the "Manual Configuration" option and the right version of Python (the same one you used to create your virtualenv).
- NOTE: Make sure you choose Manual Configuration, not the "Django" option, that's for new projects only.
Enter your virtualenv name
Once that's done, enter the name of your virtualenv in the Virtualenv section on the web tab and click OK.
You can just use its short name "mysite-virtualenv", and it will automatically complete to its full path in /home/username/.virtualenvs.
Optional: enter path to your code
Although this isn't necessary for the app to work, you can optionally set your working directory and give yourself a convenient hyperlink to your source files from the web tab.
Enter the path to your project folder in the Code section on the web tab, eg /home/myusername/mysite in Source code and Working directory
Edit your WSGI file
One thing that's important here: your Django project (if you're using a
recent version of Django) will have a file inside it called
wsgi.py. This is
not the one you need to change to set things up on PythonAnywhere -- the
system here ignores that file.
Instead, the WSGI file to change is the one that has a link inside the "Code"
section of the Web tab -- it will have a name something like
Click on the WSGI file link, and it will take you to an editor where you can change it.
Delete everything except the Django section and then uncomment that section. Your WSGI file should look something like this:
# +++++++++++ DJANGO +++++++++++ # To use your own Django app use code like this: import os import sys # assuming your Django settings file is at '/home/myusername/mysite/mysite/settings.py' path = '/home/myusername/mysite' if path not in sys.path: sys.path.insert(0, path) os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings' ## Uncomment the lines below depending on your Django version ###### then, for Django >=1.5: from django.core.wsgi import get_wsgi_application application = get_wsgi_application() ###### or, for older Django <=1.4 #import django.core.handlers.wsgi #application = django.core.handlers.wsgi.WSGIHandler()
- Be sure to substitute the correct path to your project, the folder that contains manage.py, which you noted above.
- Don't forget to substitute in your own username too!
- Also make sure you put the correct value for
- This guide assumes you're using a recent version of Django, so leave the old
wsgi.WSGIHandler()code commented out, or better still, delete it.
Save the file, then go and hit the Reload button for your domain. (You'll find one at the top right of the wsgi file editor, or you can go back to the main web tab)
If, like most sites, your site uses a database, you'll need to set that up.
Go to the Consoles tab, start a bash console, use
cd to navigate to the
directory where your Django project's
manage.py lives, then run
Checking it worked.
What to do if you see any errors.
First, check your error log. You'll find a link to it on your web tab.
There are many different ways to set things up so that your database settings,
SECRET_KEY, and so on are different in your local environment to the settings
in your live environment on PythonAnywhere. If you're specifically using
environment variables to store them, this page on
setting environment variables for web apps
Then, head over to the help page on Static files in Django for instructions on how to set up static file serving.