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 port 8000 on the cluster must be open only for internal network access, allowing access to the following services using the corresponding endpoints:

🚧

Warning

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

Installation

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

docker run -d -p 8000:8000 -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 Advanced Configuration page.

Initial Configuration

To configure your Akeyless Gateway:

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

2. Navigate to Gateways > Select Your Gateway > Manage Gateway

Tutorial

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