Knowledge Base

How to install and configure Django on unmanaged servers

This article demonstrates how to install and configure Django on an unmanaged server.

Installing Django

To install Django, you first create a virtual environment for Python by using the virtualenv tool. After you activate the virtual environment, you can use the pip installer to install Django.

To do this, follow these steps:

  1. Log in to your server using SSH.
  2. As the root user, type the following commands appropriate for your Linux distribution:
    • Debian and Ubuntu:
      apt-get install python3
      apt-get install python3-pip
      pip3 install virtualenv
      
    • CentOS and Fedora:

      yum install python34
      yum install python34-pip
      pip3 install virtualenv
      
  3. As a regular (non-root) user, type the following commands:

    cd ~
    mkdir django-apps
    cd django-apps
    virtualenv env
    source env/bin/activate
    pip install django
  4. Django is now installed. To determine which version is installed, type the following command:

    django-admin --version

Configuring Django

Django is now installed, and you can create and configure a Django application. To do this, follow these steps:

  1. As a regular (non-root) user, type the following command:
    cd ~/django-apps
    django-admin startproject mysite
    
  2. Use a text editor to open the /home/username/django-apps/mysite/mysite/settings.py file. Replace username with the account username.
  3. Confirm that debug mode is enabled:

    DEBUG = True
  4. Locate the ALLOWED_HOSTS line, and then modify it as follows. Replace xxx.xxx.xxx.xxx with the IP address of your server:

    ALLOWED_HOSTS = ['xxx.xxx.xxx.xxx']
  5. Save your changes to the settings.py file.
  6. To start the development web server, type the following command. Replace xxx.xxx.xxx.xxx with the IP address of your server:

    python ~/django-apps/mysite/manage.py runserver xxx.xxx.xxx.xxx:8000
  7. Use your web browser to visit http://xxx.xxx.xxx.xxx:8000, where xxx.xxx.xxx.xxx is your server IP address. You should see the following message:

    The install worked successfully! Congratulations!
Configuring the administration interface

Django includes an administration interface that you can use to modify web site applications, manage users and groups, and more. To configure the Django administration interface, follow these steps:

  1. At the command prompt, type the following commands:
    cd ~
    python ~/django-apps/mysite/manage.py migrate
    python ~/django-apps/mysite/manage.py createsuperuser
    
  2. At the Username prompt, type the administrator username, and then press Enter.
  3. At the Email address prompt, type the administrator e-mail address, and then press Enter.
  4. At the Password and Password (again) prompts, type the administrator password, and then press Enter.
  5. If the development web server is not running, type the following command. Replace xxx.xxx.xxx.xxx with the IP address of your server:

    python ~/django-apps/mysite/manage.py runserver xxx.xxx.xxx.xxx:8000
  6. Use your web browser to visit http://xxx.xxx.xxx.xxx:8000/admin, where xxx.xxx.xxx.xxx is your server IP address.
  7. Log in to the administration interface using the username and password that you specified in steps 2 and 4.

More Information

Now that you have a Django-enabled web site up and running, you can start the real work of developing your own applications. The following resources can help: