Page tree
Skip to end of metadata
Go to start of metadata

The items listed below are required for supported instances of Ubersmith, and are part of our standard Ubersmith terms of service. Support for the Ubersmith hardware and host environment remain the responsibility of the client. However, the Ubersmith support team will maintain the Ubersmith installation and perform upgrades as part of the Ubersmith service agreement. 

Hardware Requirements

The on-premise version of Ubersmith requires TWO servers.

The first server hosts Ubersmith's web interface or front end, and is referred to as the instance server. The minimum hardware specifications for the instance server are as follows:

  • Dedicated host or VPS
  • 8GB RAM
  • Minimum 100GB disk space allocated to / .

The second server, referred to as the appliance, is responsible for monitoring and polling all infrastructure devices associated with your Ubersmith instance. This machine's work is extremely disk I/O intensive, so we suggest installing the fastest hard drives available. The minimum hardware specifications for the appliance server are as follows:

  • Dedicated host
  • 8GB RAM
  • Minimum 100GB disk space allocated to / .

Browser Requirements

The following browsers are supported by Ubersmith:

  • Google Chrome
  • Mozilla Firefox
  • Microsoft Internet Explorer 10+/Edge

Operating System Requirements

Ubersmith clients arranging for Ubersmith's support team to install Ubersmith must provide a clean, unconfigured install of the latest build of one of the following operating systems for both servers:

  • CentOS Stream 8.x
  • Debian 10
  • Ubuntu 20 LTS

Ensure that a 64-bit (x86_64) kernel is configured.

If deploying CentOS 8, please use the default filesystem type, XFS and ensure that dtype is set to true.

No further configuration beyond the base operating system with SSH connectivity is required.

If you are handling the installation, please contact Ubersmith support for more information. 


  • If you would like our deployment process to automatically configure a Let's Encrypt certificate to secure your web and mail servers, ensure that HTTPS connections are open to the public, and that a DNS 'A' record exists for the URL / address that you plan to use for Ubersmith.
  • If you are configuring an external database host, be sure to deploy MySQL 5.7 or Percona Server for MySQL 5.7. Also, ensure that the sql_mode directive is configured as follows:

Percona XtraDB Cluster (PXC) 

Installation and configuration of Percona XtraDB Cluster (PXC) cluster nodes is beyond the scope of support that Ubersmith is able to provide. We suggest following the Percona documentation, which suggests using a minimum of a cluster with three nodes, a load balancer (such as HAProxy) and the clustercheck utility for health monitoring and failover. If you have any questions about configuring Percona XtraDB Cluster, our support team will be happy to answer them for you.


Ubersmith can not run on servers running cPanel or similar control panels.

On this page:

On this page:

Related Topics 

Implementation Home