System requirements

Bugsnag On-premise system requirements


Replicated supports Linux-based servers that can run current versions of Docker. For more information check the supported operating systems page.


Bugsnag requires a minimum of 200GiB to function in its data directory. Your exact storage size requirements will vary depending on the volume of events and size of those events. As an estimate we recommend allowing 4 GiB per million events stored to give yourself enough breathing room.

A minimum of 35GiB is required on the root partition(/) for storing the Bugsnag On-premise docker images and containers.

The drive you use as your data drive should use a stable, performant file system like Ext4 or XFS if possible. An SSD is heavily recommended. Ideally this drive also supports filesystem snapshots either through a virtualization layer (like EBS) or at the filesystem level using LVM snapshots or ZFS snapshots to make backups easier to manage.


Bugsnag requires at least a dual-core CPU, and that will work for low volume installations where you expect sporadic crash volume. For anything more than that we recommend going with a quad-core CPU. If you have high throughput applications sending events to your instance, you could find you need more cores, or even clustering your Bugsnag On-premise instance so that you can horizontally scale. Your contacts at Bugsnag can help you try to estimate your load.


Bugsnag requires at least 16GiB of memory to function. Your memory requirements will be a function of how many events you are planning to search across, but for most customers the 32GiB will be plenty. If you are finding your dashboard is slowing down you will likely need more memory, or to reduce the number of events being stored in your instance.



Bugsnag requires at least version 17.05.0-ce of Docker and we recommend 17.06.2-ce. Our installation scripts will help you install a suitable version of Docker if you don’t already have one.

We recommend configuring the port range that Docker uses to assign dynamic ports to avoid port collisions with named ports:

Find out the current IP range, use the following command:

$ sysctl net.ipv4.ip_local_port_range

Then set the upper range of local ports to 48999 by first stopping Docker then:

Add the following to /etc/sysctl.conf:

net.ipv4.ip_local_port_range=XXXXX 48999

Load the settings by running:

$ sudo sysctl -p