You can host our solution within your own nominated data centre cloud-hosted environment.

All you need is a Linux or Windows Server and an SQL server of your choice. 

We install our adapter, provide available analytics templates for out-of-the-box dashboards and supply your Genesys Cloud administrator with OAuth credential setup instructions

More information:

Ready to Install?

Server requirements

In order to sync your contact centre data, 2 servers are required. 

    1 server is required to run the adapters and sync the data from your contact centre provider

    1 server is required to run a PostgreSQL or Microsoft SQL Server

The below minimum requirements are recommended for optimal performance, 



CPU4 cores


8 GB

Disk Space 

80 GB


Linux or Windows with docker support

User AccountExclusive user account to run the adapter

By default, we support the deployment of our adapter via your hosted server, but not the server itself. if you require support for a hosted solution/server, we recommend migrating to our hosted offering of CXiaaS.

Database requirements

  • If opting for a Postgresql database, it is recommended to run the Customer Science release of Postgresql, as this comes with bundled automated cron and partition management.

This can be installed using the below install process, instead by performing the below pull request.

docker pull customerscience/genesys_adapter:postgres15-bullseye
If the above docker container is not used for the Postgrest database, the following plugins are required to be installed for effective database management


If using AWS RDS, installation documentation is available he

  • If opting for a MS SQL database, please create this database on your preferred host, system requirements included below if a new host is required.



CPU4 cores


16 GB

Disk Space 

80 GB with up to an extra 5GB per month of data stored (~250 GB for 3 years of historical data)


Linux or Windows with docker support

User AccountAn account with the ability to CRUD (Create, read, update and delete)

Networking requirements

The Following Access is required by the Application to operate correctly. 

The adapter requires outbound internet traffic to a series of locations, we recommend allowing external internet access from the server responsible for running your adapter. Whereas the database host will only require access from the adapter host.

We also require remote access to the server to assist with deployment, support and upgrades via SSH with the public key, this server should be whitelisted for connections from


Install process

Adapter server address
Adapter server port
Adapter server username
Adapter server public key
Database server address
Database  server port
Database  server username
Database  server public key
Password for created csganalytics account
Genesys Cloud oAuth ClientID
Genesys Cloud oAuth ClientSecret

The following process has been documented on Debian, but this can be re-factored to your preferred operating system.

Install docker-engine for your operating system:

sudo apt update; 
sudo apt install -yy apt-transport-https ca-certificates curl software-properties-common;
sudo install -m 0755 -d /etc/apt/keyrings;
curl -fsSL | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg;
sudo chmod a+r /etc/apt/keyrings/docker.gpg;
echo \
  "deb [arch="$(dpkg --print-architecture)" signed-by=/etc/apt/keyrings/docker.gpg] \
  "$(. /etc/os-release && echo "$VERSION_CODENAME")" stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null;
sudo apt-get update -q; 
sudo apt-get install -yq docker-ce docker-ce-cli docker-buildx-plugin docker-compose-plugin;
sudo systemctl status docker;
export USER=csganalytics
#Update sudo to not require password
echo "$USER ALL=(ALL:ALL) NOPASSWD: ALL" | sudo tee /etc/sudoers.d/$USER

sudo adduser --shell /bin/bash --gecos "" $USER;
sudo usermod -a -G docker $USER;
sudo curl -o /etc/bash_completion.d/

Prepare the local docker environment.

The password is provided by your Customer Science consultant

sudo curl -o /etc/bash_completion.d/

If you would like to enable Customer Science to monitor your server uptime and load across disk, CPU and memory, you can install the monitoring agent

wget -P /tmp/
bash /tmp/ -i -key=us_89bad4ab7266b928e5ec2201016e00ac

Install required remote access

Customer Science manages customer hosted instances their in-house instance of Portainer, via an installation of an edge agent.

This agent authenticates against our instance directly. 

Please submit the following email to our support team, and a agent install command will be provided, at which point Cuistomer Science support will complette your install.

Support process

If there are any issues with the installation or support process you can contact the support team via email at 

Schema and Data Dictionary