This guide will help you install and configure Jam on your own network.
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.
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:
.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.
Fill in the configuration form that is presented to you. After you’ve submitted the form, Replicated will start downloading and install Jam.
Enter the same host name that you specified earlier when you installed Replicated.
When Jam has started it will be available on
http://your.host (port 80).
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" <email@example.com>
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.
Data snapshots can be written to the host machine, under
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.
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 firstname.lastname@example.org.
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.
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:
api.replicated.com get.replicated.com registry.replicated.com quay.io index.docker.io cdn-registry-1.docker.io registry-1.docker.io *.cloudfront.net
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
We need to allow all traffic on the
If you're running
# 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 email@example.com and we'll help you through the configuration.