Skip to content

Latest commit

 

History

History
68 lines (45 loc) · 2.04 KB

README.md

File metadata and controls

68 lines (45 loc) · 2.04 KB
Raw

Heroku Django Starter Template

An utterly fantastic project starter template for Django 1.11.

Features

  • Production-ready configuration for Static Files, Database Settings, Gunicorn, etc.
  • Enhancements to Django's static file serving functionality via WhiteNoise.
  • Latest Python 3.6 runtime environment.

How to Use

To use this project, follow these steps:

  1. Create your working environment.
  2. Install Django ($ pip install django)
  3. Create a new project using this template

Configuring Go Packages

  1. If you haven't already, install Go with brew install go
  2. Add the following lines to your ~/.bash_profile
export GOPATH=$HOME/golang
export GOROOT=/usr/local/opt/go/libexec
export GOBIN=$GOPATH/bin
export PATH=$PATH:$GOPATH
export PATH=$PATH:$GOROOT/bin
export PATH=$GOPATH/bin:$PATH
  1. Navigate to the root directory of the project. In this case, that would be the lsproject folder
  2. Install the primary Go packages using go install ./cmd/going_going_gone
  3. Now, you should be able to test the app locally using heroku local

Creating Your Project

Using this template to create a new Django app is easy::

$ django-admin.py startproject --template=https://github.com/heroku/heroku-django-template/archive/master.zip --name=Procfile helloworld

(If this doesn't work on windows, replace django-admin.py with django-admin)

You can replace helloworld with your desired project name.

Deployment to Heroku

$ git init
$ git add -A
$ git commit -m "Initial commit"

$ heroku create
$ git push heroku master

$ heroku run python manage.py migrate

See also, a ready-made application, ready to deploy.

Using Python 2.7?

Just update runtime.txt to python-2.7.13 (no trailing spaces or newlines!).

License: MIT

Further Reading