Skip to content

Installation using Docker

Jump to bottom
matamorphosis edited this page Jan 16, 2023 · 5 revisions

License: GPL v3

Installation using Docker

PLEASE FOLLOW CAREFULLY AS THERE IS INFORMATION PRINTED IN THE TERMINAL THAT WILL NEED TO BE RETAINED

Docker automates almost the entire installation process and doesn't give you the choice of OS, Ubuntu 20.04 is the current distribution used.
This guide assumes you have docker installed on your system already and know the essentials of docker and how its virtualised environments work.

Notes

  1. For those that are new to docker, running "docker run..." creates a new container, so all changes will be lost after the build. Use "docker start" followed by "docker attach" to not overwrite changes.
  2. Unlike the regular installation of Google Drive Access Governance, the IP address displayed on run is not the IP address you access GDAG from. This is because GDAG is running in a Docker container on your host in a virtualised network. This network uses network address translation (NAT) and the docker run command below maps the internal port 443 in your virtualised environment to port 443 on your host so you can access it. You need to access GDAG using the NAT IP address. If running Docker on a Linux host you can use the ifconfig or the ip addr command to find the Docker IP address on your host, that will be the IP address used to access GDAG.
  3. Only one option is supported for running dockerised GDAG, which is through docker-compose. Not using docker-compose will significantly increase the difficulty of getting the platform working.
  4. It is not recommended to expose either of the GDAG images to the internet. This platform is designed for internal use only.

Option 1: Using the docker-compose.yml file included in this repository

  1. If not done already, navigate to the Docker Installation directory
user@linux:~$ cd GDAG
  1. Bring up container using the following commands.
user@linux:/<PATH-TO-GDAG>$ docker-compose up
  1. If you want to upload your own certificate pair, copy the private key and the certificate to the /certs directory in the gdag-appliance container:
user@linux:/<PATH-TO-GDAG>$ docker cp privateKey.key [CONTAINER-ID]:/certs/privateKey.key
user@linux:/<PATH-TO-GDAG>$ docker cp certificate.crt [CONTAINER-ID]:/certs/certificate.crt
  1. Find your docker container's IP address through using either the ifconfig or ipconfig command. Then navigate to https://[DOCKER-IP-HERE], accept the certificate (if using self-signed), and log in with the user admin and the password provided to you in the previous step. In most cases you can use https://localhost
Clone this wiki locally