Skip to content

Deploy on Amazon EC2

Deploy Graph Explorer onto an Amazon EC2 instance and use it as a proxy server with SSH tunneling to connect to Amazon Neptune.

  • Provision an Amazon EC2 instance that will be used to host the application and connect to Neptune as a proxy server. For more details, see instructions here.
  • Ensure the Amazon EC2 instance can send and receive on ports 22 (SSH), 8182 (Neptune), and 443 or 80 depending on protocol used (graph-explorer).
  • Docker installed on the EC2 instance
  • AWS CLI installed on the EC2 instance
  1. Open an SSH client and connect to the EC2 instance

  2. Authenticate with the Amazon ECR Public Registry

    aws ecr-public get-login-password --region us-east-1 | docker login --username AWS --password-stdin public.ecr.aws
  3. Pull the Docker image

    docker pull public.ecr.aws/neptune/graph-explorer
  4. Run the container substituting the {hostname-or-ip-address} with the hostname or IP address of the EC2 instance

    docker run -p 80:80 -p 443:443 \
    --restart unless-stopped \
    --env HOST={hostname-or-ip-address} \
    public.ecr.aws/neptune/graph-explorer
  5. Navigate to the public URL of your EC2 instance accessing the /explorer endpoint. You will receive a warning as the SSL certificate used is self-signed. The URL will look like this:

    https://ec2-1-2-3-4.us-east-1.compute.amazonaws.com/explorer
  6. Since the application is set to use HTTPS by default and contains a self-signed certificate, you will need to add the Graph Explorer certificates to the trusted certificates directory and manually trust them. See HTTPS Connections section.

  7. After completing the trusted certification step and refreshing the browser, you should now see the Connections UI.