Skip to content

Latest commit

 

History

History
79 lines (55 loc) · 2.01 KB

setup_docker.md

File metadata and controls

79 lines (55 loc) · 2.01 KB

Setup Docker


Requirements


Docker


Please checkout https://docs.docker.com/engine/installation/ for docker installation.

Launch instance


The docker container includes all three Athenz Services - ZMS, ZTS and UI. Internally they're running on the following ports:

Service Port
ZMS 4443
ZTS 8443
UI 9443

and those three ports must be exposed and available on the docker host as well.

Once docker is successfully installed, launch Athenz by executing the following docker command.

$ docker run -itd -h <server-hostname> -p 9443:9443 -p 4443:4443 -p 8443:8443 -e ZMS_SERVER=<server-hostname> -e UI_SERVER=<server-hostname> athenz/athenz

To access Athenz UI, open your browser with url

https://<server-hostname>:9443/athenz

Since the services are running with self-signed certificates, configure your browser to ignore the warnings regarding the UI server certificate.

The administrator must first access the ZMS Server endpoint in the browser to accept the exception since the Athenz UI contacts ZMS Server to get an authorized token for the user when logging in. The administrator must access:

https://<server-hostname>:4443/zms/v1/schema

The container is configured with the following default user details:

User Password
athenz athenz

Start/Stop Athenz


Run docker ps to get the CONTAINER_ID first and then use the extracted container id with docker stop command:

$ docker ps --filter "ancestor=athenz/athenz" -q
$ docker stop CONTAINER_ID

To start Athenz, execute the following commands first to determine the stopped Athenz container id and then start the container with docker start command:

$ docker container ls -a
$ docker start CONTAINER_ID