How to run ACP on Docker

Purpose

This section describes how to run ACP on Docker.

Prerequisites

Hardware

Before installing ACP, make sure your machine fulfills the following minimum hardware requirements:

Type Minimum Recommended
CPU 1 x 2.60GHz with native 64-bit support 2 x 2.60GHz with native 64-bit support
Memory 1 GB 4 GB
Free hard drive space 4 GB 8 GB
Network connection 100 Mbps 1000 Mbps

Software

Before installing ACP, make sure your machine has the following software installed:

  • Docker 19.03.x

  • PostgresSQL supported version: Postgres 11.5

    ACP requires the postgresql database to run. It can be configured with the --sql.url flag and format postgres://user:password@postgres/database.

  • Hazelcast supported version: Hazelcast 3.12

    ACP requires Hazelcast to run. It can be configured with the --hazelcast.address flag and format host:port.

Login credentials

Obtain your login credentials to the Cloudentity’s Docker repository by contacting our sales team at sales@cloudentity.com and requesting the access to the ACP preview.

Installation

  1. Log in to the Cloudentity’s Docker repository by executing

    echo '<<docker repository credentials>>' | docker login -u acp acp.artifactory.cloudentity.com --password-stdin
    

    Note

    The access to the Cloudentity’s Docker repository is needed to download images.

  2. Run the service on Docker by executing

    docker run -it acp.artifactory.cloudentity.com/acp:1.9.2 server start \
        --create-default-tenant \
        --sql.url "postgres://user:password@postgres/authorization?sslmode=disable" \
        --hazelcast.address hazelcast:5701 \
        --secret.key KNEcLGdDqpwrXDubqPgDSUkMMsLPXaHh
    

    Read more

    For a detailed description of available commands, see the reference.