Prerequisites

An Authentication Method. Make sure it has the right access permission to create and manage Secrets, Keys & Targets.

👍
Tip
The following example uses the account default Authentication Method. Using the account owner's email and password which has superuser privileges on the account.

A Linux or a Windows machine with Docker engine installed with a minimum 1 vCPU available with 2GB RAM.
Network connection to Akeyless SaaS Core Services from your machine.

🚧
Note
Make sure that this server is not globally opened to the public network. Akeyless Gateway requires only connections to Akeyless SaaS Core Services.

The following ports need to be open on the server only for internal network access:

Service	Port
Gateway Configuration Manager	8000
Gateway Console	18888
HVP	8200
Akeyless V1 REST API	8080
Akeyless V2 REST API	8081
KMIP Server	5696

Installation

To install a standalone instance of Akeyless Gateway, run the following command:

docker run -d -p 8000:8000 -p 8200:8200 -p 18888:18888 -p 8080:8080 -p 8081:8081 -p 5696:5696 --name akeyless-gateway akeyless/base:latest-akeyless

After executing the above command, a new container named akeyless-gateway should run on Docker (use docker ps for confirmation). It contains a single instance of Akeyless Gateway.

To upgrade your current Gateway version, simply restart the container using the docker restart <container name> command.

👍
Info
In this example, the Gateway was installed without a default Authentication Method as part of the installation. Thus, the first Authentication Method used to log in will become the admin user on this Gateway.

For further installation options, visit the Advanсed Configuration page.

Initial Configuration

To configure your Gateway:

On your browser, navigate to http://Your-Akeyless-Gateway-URL:8000.
Enter your credentials to log in.