Deploying AnzoGraph with Docker

Follow the appropriate instructions below to deploy AnzoGraph using Docker. For information about the Docker installation and requirements, see Docker Installation and Configuration Requirements.

Follow the instructions below to deploy AnzoGraph on Docker Desktop for Mac.

  1. If necessary, start the Docker Desktop application, and then open the Mac Terminal app.
    NoteDocker caches images on the docker host. If you have deployed an AnzoGraph container previously, that image is cached on the host and will be used to redeploy AnzoGraph. If you want to deploy the latest release, first pull the latest image. To do so, run the following command in Terminal, and then proceed to the next step. 
    docker pull cambridgesemantics/anzograph:latest

    You can deploy alternate AnzoGraph versions by replacing the "latest" tag with any of the tags that are available on the AnzoGraph Docker Hub site.

  2. In Terminal, run the following Docker command to deploy the AnzoGraph image. The command instructs Docker to start AnzoGraph and configure HTTP and HTTPS access to the application by mapping the container ports to the HTTP and HTTPS ports on the local host:
    docker run -d -p host_http_port:8080 -p host_https_port:8443 --name=container_name cambridgesemantics/anzograph:tag

    The list below describes each of the parameters:

    • host_http_port is the port on the local host to use for HTTP access to the AnzoGraph user interface. In the container, the user interface binds to port 8080 for HTTP access. Cambridge Semantics recommends that you specify 80 to map the container's HTTP port to port 80 on the local host. If port 80 is in use, specify an alternate port for host_http_port.
    • host_https_port is the port on the local host to use for HTTPS access to the AnzoGraph user interface. In the container, the user interface binds to port 8443 for HTTPS access. Cambridge Semantics recommends that you specify 443 to map the container's HTTPS port to port 443 on the local host. If port 443 is in use, specify an alternate port for host_https_port.
    • container_name is the short name to use to identify the AnzoGraph container. For example, anzograph.
    • tag is the tag from the AnzoGraph Docker Hub site that identifies the version of AnzoGraph to deploy. If you pulled an image in the first step, this tag should match the tag from the pull command. Usually the latest tag is specified so the most recent release is deployed.

    For example:

    docker run -d -p 80:8080 -p 443:8443 --name=anzograph cambridgesemantics/anzograph:latest

    When the prompt returns the container ID, the container is running. For example:

    c16b912a4a8944592297cf052f90447a5657c3362540334aba2195ae8941f1af

AnzoGraph is now installed and ready to use. You can click the Docker icon in the menu bar and select Dashboard to open the Docker Dashboard and view the AnzoGraph container and its status. The Dashboard also provides access to functions such as stopping or deleting the container. For example:

Hover the pointer over the container to view the available functions. To open the AnzoGraph user interface, click the Open in browser icon (), the first icon on the left.

You can also access the user interface by opening a browser and going to http://127.0.0.1. If you specified a port other than 80 for the host HTTP port, specify that port in the URL. For example, http://127.0.0.1:8888.

Use the following credentials to log in to the user interface:

  • Username: admin
  • Password: Passw0rd1

For next steps, see Getting Started with AnzoGraph, a brief tutorial designed to introduce you to the AnzoGraph user interface and command line interface and get you started with loading data and running SPARQL queries.

Follow the instructions below to deploy AnzoGraph on Docker for Linux.

Tip You might want to follow the steps in Post-installation steps for Linux to make sure that a non-root user can run Docker commands and you do not need to include "sudo" in the commands below.
  1. If necessary, start Docker with sudo systemctl start docker.
    NoteDocker caches images on the docker host. If you have deployed an AnzoGraph container previously, that image is cached on the host and will be used to redeploy AnzoGraph. If you want to deploy the latest release, first pull the latest image. To do so, run the following command, and then proceed to the next step. 
    docker pull cambridgesemantics/anzograph:latest

    You can deploy alternate AnzoGraph versions by replacing the "latest" tag with any of the tags that are available on the AnzoGraph Docker Hub site.

  2. Run the following Docker command to deploy the AnzoGraph image. The command instructs Docker to start AnzoGraph and configure HTTP and HTTPS access to the application by mapping the container ports to the HTTP and HTTPS ports on the local host:
    docker run -d -p host_http_port:8080 -p host_https_port:8443 --name=container_name cambridgesemantics/anzograph:tag

    The list below describes each of the parameters:

    • host_http_port is the port on the local host to use for HTTP access to the AnzoGraph user interface. In the container, the user interface binds to port 8080 for HTTP access. Cambridge Semantics recommends that you specify 80 to map the container's HTTP port to port 80 on the local host. If port 80 is in use, specify an alternate port for host_http_port.
    • host_https_port is the port on the local host to use for HTTPS access to the AnzoGraph user interface. In the container, the user interface binds to port 8443 for HTTPS access. Cambridge Semantics recommends that you specify 443 to map the container's HTTPS port to port 443 on the local host. If port 443 is in use, specify an alternate port for host_https_port.
    • container_name is the short name to use to identify the AnzoGraph container. For example, anzograph.
    • tag is the tag from the AnzoGraph Docker Hub site that identifies the version of AnzoGraph to deploy. If you pulled an image in the first step, this tag should match the tag from the pull command. Usually the latest tag is specified so the most recent release is deployed.

    For example:

    docker run -d -p 80:8080 -p 443:8443 --name=anzograph cambridgesemantics/anzograph:latest

    When the prompt returns the container ID, the container is running. For example:

    c16b912a4a8944592297cf052f90447a5657c3362540334aba2195ae8941f1af
    TipIf you want to attach to the container and explore the AnzoGraph file system, you can run the following command.
    docker exec -it anzograph /bin/bash

AnzoGraph is now installed and ready to use. To open the user interface, open a browser and go to the following URL:

https://host_IP_address

If you mapped the container's HTTPS port to port 443 on the host, you do not need to specify a port. If you specified a port other than 443, include the port in the URL. For example, https://10.100.0.1:8888.

Note If you are using Docker locally on a Linux machine and need to know the IP address of the AnzoGraph container, you can run the following command: 
docker inspect container_name | grep '"IPAddress"' | head -n 1

For example:

docker inspect anzograph | grep '"IPAddress"' | head -n 1
"IPAddress": "172.17.0.2"

Use the following credentials to log in to the user interface:

  • Username: admin
  • Password: Passw0rd1

For next steps, see Getting Started with AnzoGraph, a brief tutorial designed to introduce you to the AnzoGraph user interface and command line interface and get you started with loading data and running SPARQL queries.

Follow the instructions below to deploy AnzoGraph on Docker Desktop for Windows.

  1. If necessary, start the Docker Desktop application, and then open the Windows PowerShell application.
    NoteDocker caches images on the docker host. If you have deployed an AnzoGraph container previously, that image is cached on the host and will be used to redeploy AnzoGraph. If you want to deploy the latest release, first pull the latest image. To do so, run the following command in PowerShell, and then proceed to the next step. 
    docker pull cambridgesemantics/anzograph:latest

    You can deploy alternate AnzoGraph versions by replacing the "latest" tag with any of the tags that are available on the AnzoGraph Docker Hub site.

  2. In PowerShell, run the following Docker command to deploy the AnzoGraph image. The command instructs Docker to start AnzoGraph and configure HTTP and HTTPS access to the application by mapping the container ports to the HTTP and HTTPS ports on the local host:
    docker run -d -p host_http_port:8080 -p host_https_port:8443 --name=container_name cambridgesemantics/anzograph:tag

    The list below describes each of the parameters:

    • host_http_port is the port on the local host to use for HTTP access to the AnzoGraph user interface. In the container, the user interface binds to port 8080 for HTTP access. Cambridge Semantics recommends that you specify 80 to map the container's HTTP port to port 80 on the local host. If port 80 is in use, specify an alternate port for host_http_port.
    • host_https_port is the port on the local host to use for HTTPS access to the AnzoGraph user interface. In the container, the user interface binds to port 8443 for HTTPS access. Cambridge Semantics recommends that you specify 443 to map the container's HTTPS port to port 443 on the local host. If port 443 is in use, specify an alternate port for host_https_port.
    • container_name is the short name to use to identify the AnzoGraph container. For example, anzograph.
    • tag is the tag from the AnzoGraph Docker Hub site that identifies the version of AnzoGraph to deploy. If you pulled an image in the first step, this tag should match the tag from the pull command. Usually the latest tag is specified so the most recent release is deployed.

    For example:

    docker run -d -p 80:8080 -p 443:8443 --name=anzograph cambridgesemantics/anzograph:latest

    When the prompt returns the container ID, the container is running. For example:

    c16b912a4a8944592297cf052f90447a5657c3362540334aba2195ae8941f1af

AnzoGraph is now installed and ready to use. You can right-click the Docker icon in the Windows task bar and select Dashboard to open the Docker Dashboard and view the AnzoGraph container and its status. The Dashboard also provides access to functions such as stopping or deleting the container. For example:

Hover the pointer over the container to view the available functions. To open the AnzoGraph user interface, click the Open in browser icon (), the first icon on the left.

You can also access the user interface by opening a browser and going to http://127.0.0.1. If you specified a port other than 80 for the host HTTP port, specify that port in the URL. For example, http://127.0.0.1:8888.

Use the following credentials to log in to the user interface:

  • Username: admin
  • Password: Passw0rd1

For next steps, see Getting Started with AnzoGraph, a brief tutorial designed to introduce you to the AnzoGraph user interface and command line interface and get you started with loading data and running SPARQL queries.

Related Topics