Configuring Python 3, Pyramid and Gunicorn on Ubuntu 16.04

Post updated by Matt Makai on August 10, 2016. Originally posted on June 19, 2016.

Canonical's Ubuntu 16.04 Long Term Support (LTS) Linux operating system, also known as "Xenial Xerus", was released in April 2016. It is the first Ubuntu release to include Python 3 instead of Python 2 as its default Python installation.

The Pyramid web framework has long supported Python 3. With just a few short steps we can start a new Pyramid project and run it with Green Unicorn (Gunicorn) on Ubuntu 16.04.

Required Tools

Our project requires Ubuntu 16.04 plus several code libraries. You do not need to install these tools yet - we will get to them in turn as the walkthrough progresses. Our requirements and their current versions are:

If you are developing on Mac OS X or Windows, you can use virtualization software such as Parallels or VirtualBox with the Ubuntu .iso file. Either the amd64 or i386 version of 16.04 is fine. While creating this I used the amd64 version.

A desktop screen like this one appears when you boot up Ubuntu.

Open a new terminal window so we can be ready to install required system packages.

Install System Packages

The precise Python version can be shown using the python command with the --version argument.

python3 --version

We can also view where the python3 program is installed on Ubuntu using the which command.

which python3

Ubuntu requires a few system packages before we can properly install Pyramid and Gunicorn. When we run the apt command to install system packages we will be prompted for the superuser password. Restricted system access is necessary to modify files within the system folders.

sudo apt-get install python3-dev

Press y then return to let the system package installation run.

The required system packages are installed. We can now install the Python-specific dependencies.

Set up a virtual environment

Create a directory for the virtual environments. Then create a new virtual environment.

# the tilde "~" specifies the user's home directory, like /home/matt
cd ~
mkdir venvs
# specify the system python3 installation
/usr/bin/python3 -m venv venvs/pyramidproj

Activate the virtual environment.

source ~/venvs/pyramidproj/bin/activate

Our prompt will change after we properly activate the virtual environment to something like (pyramidproj) [email protected]:~$.

Our virtual environment is activated with Python 3.

We should update pip and venv to the latest versions in our virtual environment.

pip install --upgrade pip setuptools

We can install whatever dependencies we want, in our case Pyramid and Gunicorn.

Install Python Packages

We can install Pyramid, Gunicorn and Waitress into our virtual environment using the pip command.

pip install pip install "pyramid==1.7" gunicorn waitress

No errors like we see in the following screenshot is a good sign.

Pyramid comes with a project starter template creation tool named pcreate. Run pcreate to generate the boilerplate for a new Pyramid project named "pyramidproj".

pcreate -s starter pyramidproj

Use the cd (change directory) command to move into the new folder.

cd ~/pyramidproj

A slew of new files have been created within the "pyramidproj" directory. These are the basic files you can customize for the web application you want to build. A good resource for understanding and modifying these files is to follow the quick tutorial for Pyramid.

For now, we just want to use Gunicorn to run our starter pyramidproj app. Install pyramidproj into your virtual environment using the python command on setup.py.

python setup.py develop

Now we can run our app with Gunicorn. Pyramid is a paste-compatible framework, so we use the --paste argument to run the WSGI server with the "development.ini" configuration file. In addition, the -b argument tells Gunicorn which port number to bind on when the server starts.

gunicorn --paste development.ini -b :8080

Cool, we can bring up our starter Pyramid project up in the web browser at the localhost:8000 or 127.0.0.1:8000 address.

Time to develop a full-fledged web application with Pyramid!

Ready to Develop with Pyramid

Now you have a simple setup to develop Pyramid web apps using Gunicorn as the WSGI server on Ubuntu 16.04. If you need a full step-by-step tutorial to deploy your Python web application to a production environment, check out the Full Stack Python Guide to Deployments book.

To decide what to do next with your Python project, check out the Full Stack Python table of contents page.

See something wrong in this post? Fork this page's source on GitHub and submit a pull request.


Sign up for a monthly email with Full Stack Python tutorials. No spam ever.

Sponsored By

Digital Ocean logo.

Easily deploy your Python web apps to Digital Ocean's reliable cloud computing platform.


Okta logo.

Secure and manage identities in your Python web apps with Okta.


Mapbox logo.

Easily build maps, search and navigation into your Python applications with Mapbox.


Scout logo

Scout monitors the performance of your Python apps, identifying slow queries, memory bloat, and more. Free during Tech Preview.


Real Python logo

Upgrade your Python skills by reading Real Python's awesome programming email newsletter.


Matt Makai 2012-2018