AtomJump Messaging Appliance

Download VirtualBox for your platform (Windows / Linux / Mac), and the Messaging Appliance.

Unzip the Appliance file, which should create a .vmdk file. (On a Mac, you will need to use the 'Unarchiver' app since it is a larger file than the native Mac Unzipper can handle).

Run VirtualBox on your platform, and add a 'New' project.
Type = Linux
Version = Debian (64-bit)

on Windows, if you can only see ‘Debian (32-bit)’ and you are definitely on a 64-bit machine, you will need to configure your server’s BIOS setting for virtualization to be switched on. See details here.

Click 'Continue' and then ‘Use an existing virtual hard disk drive’. Select the .vmdk file from your drive.

Run the VM and when you see a login after 20 seconds or so, enter the
Username: aj_customer
Password: lander5321

Once logged in, you should first change your password. Enter the line:
and enter your old and new passwords.

Then enter the line:
hostname -I
It should show you the VM server's IP address e.g.

Then enter 'Settings' for this Virtual Machine.
Go into 'Network' and click 'Port Forwarding'.
And add a new line similar to the above, using the Guest IP as the IP address found from the 'hostname -I' command.

Typical settings are:
Protocol: TCP
Host IP:
Host Port: 5100
Guest IP: (or the IP address found after running 'hostname -I' within the server)
Guest Port: 80
The LiveWiki should now be accessible within a browser on
You should click the ‘Update the server config’ link on this page, go back, and click through to the LiveWiki.

The main appliance target page is

Important Note: the first user to be created on the system will become the admin user, with admin rights to enter passwords on a particular forum. So, before you type anything in a messaging pop-up, go to ‘Settings’ in the popup, and enter your email and password.
If you are using the AtomJump Messaging app, and you want notifications on your phone:

Your phone should be connected to the same company Wifi or VPN network as the server. The 'Loop Server URL' address to use under the 'Private Server' link on the app login page is:

http://[your server IP or host]:5100/vendor/atomjump/loop-server/


Note: This is the same address to use if you want other server software to connect to your local AtomJump Server. If this connecting software is residing on the same machine, you can use the local server IP, also i.e.

Technical Specifications

Item Specification
Operating System Debian Linux 64-bit, but runs on a host Windows Desktop, Windows Server, Mac OS X, Linux.
Software Language PHP 7.1
Database MySQL 5.7
Host Disk Space Required 10GB
RAM Required 1GB minumum
Simultaneous Users 1 up to an approx maximum of 100, depending on usage patterns
Application Software AtomJump Messaging Server 2.6.7
Default Plugins Large Stickers, App Notifications, Basic Emoticons, Language Switcher (English and Spanish included), Immediate Auto-Responder
Default Interface LiveWiki
Access Super-user file-level access, Database access on request, AtomJump support access.
Support US$ 64 (NZ$100) for TeamViewer-based remote access, plus prices for individual tasks (see the LiveWiki add-ons)
Price Free
Number of messages Approx 10 million under standard disk space
Number of shared images Approx 50,000 under standard disk space
Software Updates Manual, Debian OS updates. Application updates can be done by Support.
Security The software should be run within an internal intranet, for any secure applications. A secure https server can also be used, although it needs an individual key installation.
Client Software
Mobile browsers (e.g. iPhone or Android), Desktop browsers (incl. Chrome / Firefox / Safari / Edge /IE). Optional AtomJump Messaging app for mobile notifications.


Log in, and enter the command:
sudo nano /jet/www/default/vendor/atomjump/loop-server/config/config.json
You can scroll down with the arrow keys. Under the "email" section, you can enter a configuration for sending off email notifications. Please see the User Guide for more details.

Once you have changed the file, you can hit 'Ctrl - O' together, then push 'Return'. It should say 'Wrote xx lines'. Push 'Ctrl - X' when done.

Warning: changes to the configuration files can make your system in-operable. We recommend backing up the file beforehand with e.g.
sudo cp /jet/www/default/vendor/atomjump/loop-server/config/config.json /jet/www/default/vendor/atomjump/loop-server/config/config-backup.json

Software Updates

We recommend bringing your operating system up-to-date immediately after installation, and then at regular intervals (e.g. monthly) after that. This is particularly important if this instance is visible over the internet, as opposed to a local intranet installation.

Log in and enter the commands:
sudo apt-get update; sudo apt-get upgrade
We also recommend updating your core Messaging Server software  immediately after installation, and then at regular intervals (e.g. monthly) after that. This is particularly important if this instance is visible over the internet, as opposed to a local intranet installation. It will also fix some known issues (as listed below).

Log in and enter the command:
eval "$(curl -fsSL -H 'Cache-Control: no-cache'"
Then, click the following link to run a one-time update of your database:
[or using your own IP address at http://myipaddress:5100/vendor/atomjump/loop-server/update-indexes.php]


By default, your Appliance will notify you if you are subscribed to a forum via your email.
In order to get popup-notifications to your Android or iPhones from your Messaging Appliance, you will need to add your 'push notification' certificate keys from Google and Apple.

For Android:

Create a Firebase project on Google.
Go to
You can find the API KEY in: (gear-next-to-project-name) > Project Settings > Cloud Messaging Server Key is the API key.

Then log in to your server,
sudo nano /jet/www/default/vendor/atomjump/loop-server/plugins/notifications/config/config.json
Please see the 'Configuration' instructions above for details on entering your keys.
For iPhones:
These instructions may help getting a key from Apple, but you can also try searching the internet for 'Apple push notification certificates'.

Once you have your .pem file, log in to your server,
sudo nano /jet/www/default/vendor/atomjump/loop-server/plugins/notifications/pushcert.pem
and write in your file.

Note: you can see a sample certficate file with:
sudo nano /jet/www/default/vendor/atomjump/loop-server/plugins/notifications/pushcertSAMPLE.pem

Known Issues

1. On an Android phone, if you are using a non-secure http address for your server, and your phone browser's setting's 'Lite Mode' is switched on, you will likely find images seem to flicker every 5 seconds or so.

We would recommend switching 'Lite Mode' off to stop the flickering in your Chrome Browser's Settings page.
Alternatively, once you associate an https domain with the server, the problem should disappear.

2. You cannot use ampersands '&' in the title of a forum. Please use an alternative.

3. Versions prior to 0.6.1 have a known security issue, so we strongly recommend using versions >= 0.6.1

4. Vertically oriented images might be blurry. Please see 'Software Updates' above, and run an update on the Messaging Server software to resolve this issue.

Prior Versions