Cucumber Ltd / jam


Revert "[dx] Bump dependencies"

Romain Gérard

Currently viewing

Jam Appliance

This guide will help you install and configure Jam on your own network.


  • A linux server (see supported flavours in Replicated docs)
  • 2GB RAM minimum - 16GB RAM recommended
  • 20GB Disk
  • The following ports open:
    • 8800 for the admin console
    • 80 for the web interface or
    • 443 for the web interface if you're using SSL (https://)
    • 2222 for direct SSH/git access (optional)
  • An SMTP server to enable users to sign up and reset passwords
  • A nice cup of coffee (optional)


We use a tool called Replicated to distribute the Jam appliance as docker containers.

You're going to start by installing Replicated on your server at the command-line, then you'll use Replicated's browser-based admin console to download and install Jam.

The machine will need to be able to access the internet to pull down Docker images and talk to Replicated's servers.

Some additional steps you may need to take at this point:

Once you're satisfied that the server's connection to the ourside world is OK, we can install Replicated.

Install Replicated 2.0

Follow Replicated's installation instructions and pay close attention to the platform requirements. We recommend a fresh linux installation without Docker - Replicated will install the correct version of Docker during its own installation.

You will be asked to specify the private IP address. The Replicated admin console will only be available at this IP address.

After installing Replicated, go to its admin web console which is available at URL https://[private IP address]:8800.

If your web browser warns you that the SSL certificate is invalid, tell your browser to ignore the problem for now. If you want to, you can set up a proper SSL certificate to fix this issue later.

An additional step you may need to take at this point, if you're running a firewall:

Activate your License

Upload the .rli file you received from us to the Replicated console.

After doing this you will receive an email with an activation code from Replicated.

Enter this code into the Replicated admin console.

You will then be asked to set up a password for the admin console.

Configure Jam

Fill in the configuration form that is presented to you. After you’ve submitted the form, Replicated will start downloading and install Jam.

Host name

Enter the same host name that you specified earlier when you installed Replicated. When Jam has started it will be available on (port 80).

SMTP configuration

Jam sends emails to users, for example when they sign up for accounts or reset their passwords, or engage in conversations about documents.

The Replicated settings screen includes a section where you must configure your SMTP server settings before starting the app.

Enter the details of your SMTP server and test the configuration by pressing the blue button labelled "Test SMTP Authentication" at the bottom of the E-mail settings configuration section.

The SMTP server address can include a port e.g.

The From email address is the email address that emails sent by Jam will be addressed from. This setting can include the name of the sender as well as an email address, e.g. "My Company's Jam" <>

Update to new releases

Jam will update itself automatically.

You can go to the Replicated admin console dashboard to see what version is currently running, browse through previous versions and read release notes.

Additional information

Backups (Snapshots)

Data snapshots can be written to the host machine, under /var/lib/replicated/snapshots.

You can enable automatic, scheduled snapshotting from the Replicated admin console (Gears dropdown -> Console Settings -> Snapshot & Restore), or

We recommend you set up a cron job or similar to back up the snapshot data to a secure location.

The snapshots contain a backup of Jam's internal Postgres database and git repositories.

See the Replicated Snapshot Documentation for more details.

Restoring a backup

See the Replicated Restore Documentation


If anything goes wrong during the installation or while running Jam, we’ll be able to help you better if you send us support bundle from your appliance.

Please send them to us by email at

Support bundle

A support bundle can be downloaded from your Replicated admin console. This is a file that contains logs and other diagnostic information about your environment.

Go to Support and click the Download Support Bundle button.

Configure your proxy

If you use a proxy server to access the internet, you may need to white-list the following domains, which will be accessed during the installation:

Configure your firewall

Make sure to install and start any firewall software (such as firewalld) before installing Replicated. This is because docker will set its own iptables rules, and some firewalls will overwrite those rules when they start.

If you have an external firewall in front of the host you need to open the following ports for incoming traffic:

80    for http
443   for https
8800  for access to the Replicated admin console

# for docs publishing via direct git+ssh access
2222  for git+ssh access
22    for host ssh access

Configure firewalld for docker

We need to allow all traffic on the docker0 interface

If you're running firewalld:

# Add docker0 as trusted interface
firewall-cmd --zone=public --change-interface=docker0 --permanent

# Restart services
systemctl restart network firewalld
systemctl restart docker replicated replicated-ui replicated-operator

If you're running a different firewall software, please contact and we'll help you through the configuration.