DjangoMango Docs
  • Introduction
  • Frequently Asked Questions
  • Getting Started
  • General Guides
  • Create your Development Environment
    • Access to Linux/Unix-based OS
    • Install Docker and docker-compose
    • Set up Version Control
    • Get an IDE
  • Create your Production Environment
    • Create a Digital Ocean Server
    • Accessing your Server
    • Create a Managed Database (optional)
    • Create a Storage Space (optional)
    • Point your Domain
  • Get Started with your Product
    • Project Structure
    • Basic Configuration
    • Running your Project
  • Product Guides
    • Atomic Parrot
    • Interstellar Monk
  • Integration Guides
    • Google Analytics
    • Google reCAPTCHA
    • Disqus
    • Sendgrid
    • Stripe
Powered by GitBook
On this page
  • Install Docker
  • Using WSL? You're Not Finished
  • Check Your Versions!

Was this helpful?

  1. Create your Development Environment

Install Docker and docker-compose

The majority of DjangoMango's applications come with ready-to-run Docker compose and build files. But you'll need Docker to use these files.

PreviousAccess to Linux/Unix-based OSNextSet up Version Control

Last updated 3 years ago

Was this helpful?

We package the majority of our applications with Docker compose and build files which include everything you need to get set up. What does all that mean? Well, it means you don't need to worry about manually installing Django or any of the dependencies needed by our applications, even in a development environment. And you can be assured that you will be able to replicate the exact same environment we used to build and test your product. The catch however, is that you need to install Docker and Docker compose to take advantage of our work. So let's get to it.

Install Docker

Once you are set up with your Unix-based OS, it's time to install Docker using the for your OS. But be careful here if you are using WSL or WSL2, as you will want to install Docker Desktop via the rather than the Linux instructions. Either way, installation should be quite painless and straight forward if you follow the correct instructions.

Using WSL? You're Not Finished

For WSL users, you will need to give Docker access to the WSL distribution after you have installed it. If you are using WSL (and not WSL2), then once you have Docker Desktop installed, open up Docker settings and under the general tab, select 'Expose daemon on tcp://localhost without TLS'. Alternatively, if you are using WSL2, then open up Docker Desktop settings and select the option to 'Use the WSL 2 based engine'. It's as simple as that.

Check Your Versions!

All of DjangoMango's applications are developed and tested on a particular version of Docker and docker-compose. The version for each product will be detailed on it's product page and in it's README.md. In most cases, you will be fine to run a more recent version of Docker or docker-compose than we specify, but may encounter issues if using an older version.

Docker Desktop users can check their Docker Engine and docker-compose versions by using the 'About Docker Desktop' page.

docker version
docker-compose --version

Now, if you installed Docker via Docker Desktop, you should also have access to docker-compose off the bat. But if you installed Docker Engine on a native Unix-based OS or via a Linux-based virtual machine, you may need to install docker-compose separately. To do so, please follow the for your OS.

Or, if you only have access to terminal, you can check your current Docker Engine version by simply running the docker :

And can check your docker-compose version by running the docker-compose :

If necessary, Docker Desktop users can upgrade Docker Engine and docker-compose via the 'Check for Updates' menu. While, terminal users will need to follow the for your OS to upgrade Docker Engine, and follow to upgrade docker-compose.

correct instructions
version command
version command
correct instructions
these handy instructions
correct instructions
Windows installation instructions