- Python 3.7
- Windows 10 users can also install Python from the Windows Store
- Docker (Download for your platform)
- NOTE: if you intend to develop on Windows, you need to have Windows 10 Pro or Enterprise to be able to use Docker, and you have to have at least a somewhat recent CPU that supports Hyper-V. Any non-Atom CPU from the past 5 years should more than suffice. Also, it'll break VirtualBox 5.x and older.
- After you get Python installed, you need to open a command line (see the
Django Girls tutorial above) and run
pip3 install pipenv
to be able to install packages. - Once you have pipenv installed, install packages:
pipenv install
Start the dev server for local use:
docker-compose up
That will automatically pull the required images, install packages, and launch the
processes. If you need to rebuild your images (such as when dependencies change),
you can add --build
to the end of that command to re-fetch images and build.
Run a command inside the docker container:
docker-compose run --rm web [command]
To get to a plain shell, run docker-compose run --rm web bash
. From there, you
can run Django commands like pipenv run ./manage.py shell
.
Say you don't want to use Docker. Don't worry, here's what you need to get started:
pipenv install --dev
export DJANGO_SECRET_KEY=your_secret_key
pipenv run python manage.py runserver
You'll need to set this up anyway if you're making migrations (i.e. modifying models) outside the docker shell.