Our step-by-step guide to run reelyActive's open source software suite on a laptop or personal computer.
Learn how we at reelyActive deploy our software suite on a laptop or personal computer.
Although this tutorial is still valid, we recommend instead following the updated version:
A laptop or computer. Consider the following tutorial if preparing a dedicated computer from scratch.
Install all the prerequisites for the reelyActive open source software.
Check first if node and npm are already installed by running
node --version and
npm --version from the command line .
From the laptop , browse to nodejs.org and note the latest LTS version number available (ex: 10.15.3). Substitute this version number in all of the commands below.
tar -xf node-v10.15.3-linux-x64.tar.xz
sudo mv node-v10.15.3-linux-x64 /usr/local/node
sudo ln -s /usr/local/node/bin/node node
sudo ln -s /usr/local/node/bin/npm npm
Confirm that node and npm are successfully installed with the commands
node --version and
npm --version respectively.
From the laptop , browse to nodejs.org and follow the friendly instructions to download and install the latest LTS version for Mac.
From the laptop , browse to nodejs.org and follow the friendly instructions to download and install the latest LTS version for Windows.
Check first if git is already installed by running
git --version from the command line .
From the laptop , open a terminal and install git with the command
sudo apt-get install git-all
Consult the official git Getting Started Guide for more details, including instructions for non-Debian based Linux distributions.
The easiest way to install git is to install the Xcode Command Line Tools with which it is bundled. Open a terminal on the laptop and run
git to start the installation.
Consult the official git Getting Started Guide for more details.
Node , npm and git are now installed!
Clone our hlc-server repository on GitHub and install all dependencies using npm.
From the laptop , open a terminal and create a reelyActive folder under the home folder as follows ( Windows users can instead complete this step using Windows Explorer).
From the terminal , in the reelyActive folder, install the hlc-server software as follows.
git clone https://github.com/reelyactive/hlc-server.git
npm install1 min
From the terminal , in the hlc-server folder, run the software as follows.
The reelyActive open source software suite is now installed.
Configure the software to run as a service each time the laptop boots. ( Linux only)
This optional step applies only to Linux systems.
From the same terminal , and from the hlc-server folder, configure systemd to run the hlc-server service by completing the following:
sudo cp units/hlc-server.service /lib/systemd/system
sudo systemctl enable hlc-server.service
Observe the hlc-server landing page.
Reboot the laptop and confirm that the hlc-server landing page is indeed once again served at localhost:3001.
If necessary, it is possible to disable the service with the command
sudo systemctl disable hlc-server.service.
Continue exploring our open architecture and all its applications.