Auto Docker Install
Automated Linux Docker installer for users without Docker experience

Overview

The Auto Docker Install method provides a base level environment for a typical Keeper Connection Manager environment. This includes:
  • Connection manager for all supported protocols
  • File transfers
  • Session recording
  • Secrets Manager integration
  • MySQL-backed database
If you are already familiar with Docker, we recommend using the Docker Compose Install method.

Platform-specific Setup

Amazon Linux 2
Install Docker before installing Keeper Connection Manager. A nice step by step guide is published here.
CentOS7, RHEL
Install the haveged package to ensure that the environment is capable of generating enough entropy for creating secure random numbers.
sudo yum install epel-release
sudo yum install haveged
sudo systemctl start haveged
sudo systemctl enable haveged
Ubuntu
Install the haveged package to ensure that the environment is capable of generating enough entropy for creating secure random numbers.
sudo apt-get install haveged

Auto Docker Script

(1) Download the Installer
From the Linux command line, download the installer script using the curl command.
curl -O https://keepersecurity.com/kcm/kcm-setup.run
(2) Open HTTP/HTTPS ports for Lets Encrypt
If you are planning to use Lets Encrypt to generate the SSL certificate for the gateway, you need to open HTTP port 80 and HTTPS port 443 to the service at least during the install process.
The Lets Encrypt servers will attempt to reach the instance and it will fail the installation if there is no network connectivity.
(3) Run the Installer
Change the permissions and execute the command with sudo or root permissions.
chmod +x kcm-setup.run
sudo ./kcm-setup.run
After continuing the installation you can accept the EULA, and then you will be prompted on whether or not you already have SSL termination available on this server.
If you respond N for no, you will get the following options:

Save the Admin Password

After installation is completed, an admin login and password is created for you. Make sure to store this in your Keeper vault, as it's not provided again later.
Installation has completed successfully! You may now access your Keeper
Connection Manager installation at:
https://connection.mycompany.com/
The administrator credentials are:
Username: guacadmin
Password: **************************
Thank you for installing Keeper Connection Manager!
Store the provided guacadmin password in your Keeper Vault

Open the Login Screen

Now that the installation is complete, you should be able to load up the Keeper Connection Manager login screen by visiting the hostname specified in the setup wizard. Assuming you used Keeper to store the password, you'll be able to immediately login as the guacadmin default user.
Initial login screen

🎉
Installation Complete!

Now that your Keeper Connection Manager instance is running, you can login as guacadmin and start setting up some connections. Follow the Using Keeper Connection Manager documentation for next steps.
The next section of this documentation reviews the process of managing, upgrading and adding packages to the Docker Compose environment.
Export as PDF
Copy link
On this page
Overview
Platform-specific Setup
Auto Docker Script
Save the Admin Password
Open the Login Screen
Installation Complete!