Getting Up and Running Locally¶
Setting Up Development Environment¶
Make sure to have the following on your host:
First things first.
Activate the virtualenv you have just created.
Install development requirements:
$ pip install -r requirements/local.txt
Create a new PostgreSQL database (note: if this is the first time a database is created on your machine you might need to alter a localhost-related entry in your
pg_hba.confso as to utilize
$ createdb <what you've entered as the project_slug at setup stage>
$ python manage.py migrate
See the application being served through Django development server:
$ python manage.py runserver 0.0.0.0:8000
Setup Email Backend¶
In order for the project to support MailHog it must have been bootstrapped with
use_mailhog set to
MailHog is used to receive emails during development, it is written in Go and has no external dependencies.
For instance, one of the packages we depend upon,
django-allauth sends verification emails to new users signing up as well as to the existing ones who have not yet verified themselves.
Download the latest MailHog release for your OS.
Rename the build to
Copy the file to the project root.
Make it executable:
$ chmod +x MailHog
Spin up another terminal window and start it there:
Check out http://127.0.0.1:8025/ to see how it goes.
Now you have your own mail server running locally, ready to receive whatever you send it.
Sass Compilation & Live Reloading¶
If you’d like to take advantage of live reloading and Sass / Compass CSS compilation you can do so with a little bit of preparation.
Congratulations, you have made it! Keep on reading to unleash full potential of Cookiecutter Django.