This tutorial will walk you step by step through how to install Adapt Authoring Tool on a Ubuntu 22.04 LTS server. Everything from installing the prerequisites, through to accessing the tool in the web browser.
This tutorial assumes you already have a virtual machine or server ready to work with, and that you are familiar with the basics of using the terminal. This is tutorial written as a quick start guide and not an in-depth tutorial. For more detailed steps, follow the official documentation here.
Installing the Prerequisites
In your terminal, enter the following command to update your local package index.
sudo apt update
Git is a version control system, all you really need to know for the purpose of this tutorial is that it helps you to keep the Authoring tool up to date.
Git is distributed with Ubuntu 22.04 LTS and is likely already installed on a server, you can confirm this by running the following command:
If Git is not installed you can install it with:
sudo apt install git
Configure Git with your name and email address if needed:
git config --global user.name "Your Name" git config --global user.email "[email protected]"
Think of node as the engine that drives the Adapt Authoring tool, as well as a way to install additional parts with NPM, which is installed when you install Node.
With the intention of keeping this tutorial snappy, I'm only going to show you one of many ways to install Node.js.
We're going to use nvm in this tutorial. nvm makes it easy to install and use different versions of Node via the terminal.
Run the following command which will download and run a script to install nvm.
If you want to audit the script first or find more info you can find that here
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.3/install.sh | bash
Verify the install worked by running:
command -v nvm
If you get nothing back try closing the current terminal and open a new one, then run the command again. It should now return
Still not working? Find more detailed troubleshooting instructions here
Install the latest Node.js supported by Adapt, which is v14.19.0 (at the time of writing) by running the following command:
nvm install v14.19.0
Confirm node install:
Confirm npm install:
Grunt is the task runner which handles all the necessary actions required to build the course.
We're going to install Grunt using NPM with the following command.
npm install -g grunt-cli
MongoDB is the database for the authoring tool.
As a reminder, the following steps are essentially a QuickStart guide, for a more detail set of instructions follow the official MongoDB guide here
Import the public key used by the package management system
Install gnupg if it isn't already.
sudo apt install gnupg
Import the MongoDB public GPG key:
curl -fsSL https://pgp.mongodb.com/server-6.0.asc | \ sudo gpg -o /usr/share/keyrings/mongodb-server-6.0.gpg \ --dearmor
Create a list file for MongoDB
echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-6.0.gpg ] https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/6.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-6.0.list
Reload the local package database
sudo apt update
Install the MongoDB packages
This will install the latest stable version of MongoDB packages.
sudo apt install -y mongodb-org
Now we need to make sure MongoDB is running before proceeding. Otherwise the subsequent steps wont work.
To start MongoDB:
sudo systemctl start mongod
Check MongoDB is now running
sudo systemctl status mongod
You should see something like 'Active:' active (running) since [...] if everything is working correctly.
If you want to start MongoDB automatically after rebooting the server run the following command:
sudo systemctl enable mongod
We need to download a copy of the Adapt Authoring tool to our server ready to run the install script.
First create a folder in your desired location for the Adapt Authoring files.
I created a folder in my users home directory called adapt.
Next move into the newly created directory and download the files we need from Github.
git clone https://github.com/adaptlearning/adapt_authoring.git
Once that's downloaded we're ready to run the first install script. Change into the adapt_authoring directory and run the following command:
npm install --production
When the installation is complete, it's worth running the following to fix vulnerabilities that are not breaking changes.
npm audit fix
Now we can install and configure the Authoring tool!
Don't worry if you don't have the answers to all of the questions, you can change these after the install has completed successfully.
When asked about using a full database connection URI, enter no, unless you intend to connect to a remote database
When you reach the end of the script you'll recieve a message which says the installation is completed and that you can start the application by running the following:
Running the above command will start the node.js server, listening on the port you specified in the installation.
You should now be able to access the Adapt Authoring tool from your web browser. In your browser URL/search bar type the server IP, followed by the port number which the node server is listening on. For example:
If everything has worked successfully you will see an Adapt sign-in page where you can login with the username and password you created for your Super Admin account.
If you run into problems during install, be sure to check the official documentation and forums for further help and explanations.