Prerequisites

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

👍

Note

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.

🚧

Warning

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:

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 Akeyless Gateway:

1. On your browser, navigate to http://Your-Akeyless-Gateway-URL:8000.

2. Enter your credentials to log in.

Tutorial

Check out our tutorial video on Installing and Configuring the Gateway on Docker.