GispoCoding / aukigo-backend

Aukigo-backend

The structure partly inspired by ngz-geoviz.

Installation

Install Docker and docker-compose

Development mode

Start the backend with:

docker-compose -f docker-compose.yml up -d --build

Django can be accessed from http://localhost:8001/ and pg_tileserv from http://localhost:7800

Production mode

1. Fill the following environmental variables to the .env file (same directory as docker-compose.yml). You can copy the .env.dev to get started. Database name, password and user could be anything, remember to use your own host instead of localhost if using other host.

   DEBUG=0
   HTTPS=0
   SECRET_KEY=very-secure-password
   USE_S3=0 
   DJANGO_ALLOWED_HOSTS=localhost 127.0.0.1 [::1]
   
      
   SQL_DATABASE=aukigo_dev
   SQL_USER=aukigo_dev_user
   SQL_PASSWORD=aukigo_pwd
   SQL_HOST=localhost
   SQL_PORT=5434
   DATABASE=postgres
   
   DJANGO_SUPERUSER_USERNAME=admin
   DJANGO_SUPERUSER_PASSWORD=very-secure-password
   DJANGO_SUPERUSER_EMAIL=[e-mail]
   
   PG_TILESERV_POSTFIX=/tiles
   OSM_SCHEDULE_MINUTES=720

2. Spin up the app in production mode:

   docker-compose -f docker-compose.prod.yml up -d --build

Nginx should now be listening on port 80.

Https configuration

Easiest way is to have the certificates on the host and add them as volumes to the host.

• Follow the Certbot instructions to get the certificates
• Uncomment the line - /etc/letsencrypt:/etc/letsencrypt in docker-compose.prod.yml
• Modify .env to contain right host in DJANGO_CORS_WHITELIST (DJANGO_CORS_WHITELIST=https://your.url.com http://localhost:8080 http://localhost:8000)
• Set HTTPS=1 in .env
• Edit all occurences of example.com in nginx/nginx_https.conf to match your site
• Replace nginx/nginx.conf with nginx/nginx_https.conf, and run:

docker-compose -f docker-compose.prod.yml down
docker-compose -f docker-compose.prod.yml up -d --build

Nginx should now be listening on port 443.