Skip to content

Installation using Docker

Jump to bottom
matamorphosis edited this page Jan 31, 2022 · 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. It is recommended that you change configuration for things like API keys, via the "Edit Inputs", "Edit Outputs", and "Edit Core" functions on the settings page.
  2. 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 attach" to not overwrite changes.
  3. 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 5000 in your virtualised environment to port 5000 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.

Option 1: Using the package link

  1. Navigate to the package link here, and follow the command displayed under "Install from the command line", for reference the command is listed below:
user@linux:~$ docker pull ghcr.io/matamorphosis/gdag:latest
  1. As the package is pre-built, bring up the container using the docker run command.
user@linux:~$ docker run -p 8080:8080 -p 8000:8000 ghcr.io/matamorphosis/gdag:latest
  1. Find your docker container's IP address through using either the ifconfig or ipconfig command. Then navigate to https://:5000, accept the certificate (if using self-signed), and log in with the user admin and the password provided to you in the previous step.

Option 2: 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/installation/docker
  1. Bring up container using the following command.
user@linux:/<PATH-TO-GDAG>/installation/docker$ docker-compose up
  1. Find your docker container's IP address through using either the ifconfig or ipconfig command. Then navigate to https://:5000, accept the certificate (if using self-signed), and log in with the user admin and the password provided to you in the previous step.

Option 3: Using the Dockerfile included in this repository

  1. If not done already, navigate to the Docker Installation directory
user@linux:~$ cd GDAG/installation/docker
  1. Build the docker image
user@linux:/<PATH-TO-GDAG>/installation/docker$ docker build -t gdag/latest .
  1. Run the container.
user@linux:~$ docker run -p 5000:5000 gdag/latest
  1. Find your docker container's IP address through using either the ifconfig or ipconfig command. Then navigate to https://:5000, accept the certificate (if using self-signed), and log in with the user admin and the password provided to you in the previous step.
Clone this wiki locally