Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
The Adapt authoring tool is a node app that provides a user interface for the Adapt framework.
This version of instructions contains only the essential details. A more detailed set of installation instructions is also provided. If you need assistance troubleshooting, consult the Adapt community's Technical Discussion Forum.
1. Install Prerequisites
Tip: for advice on installing the prerequisites on Windows, check out this page.
The authoring tool requires the following:
- git git-scm.com
- Node.js nodejs.org. The authoring tool supports v8 of Node.js. We recommend using a node version manager such as nodist (Windows) or nvm (OS X, Linux), to easily switch between versions of node.
- npm npmjs.com
- grunt-cli gruntjs.com/getting-started
- MongoDB docs.mongodb.org/manual
The following is optional, but can be used to provide thumbnails for image and video assets:
- FFmpeg www.ffmpeg.org/index.html
For your convenience...
|git||downloads||Getting Started: Installing Git|
|Node.js||download||installation on various operating systems or with package manager|
|Nodist||download from GitHub||installation|
|NVM||download from GitHub||installation|
|npm||bundled with Node.js||bundled with Node.js|
|Robo 3T (formerly Robomongo)||installation packages||GitHub|
|adapt_authoring||download from GitHub||installation|
To install the Grunt command-line interface globally:
npm install -g grunt-cli
Robo 3T is not required, but you might find it helpful in your work with MongoDB.
We recommend cloning the code using git (rather than just grabbing a zip), because it not only allows you to very easily pull in the latest updates non-destructively, but it also makes it easy to contribute changes back to the project! 🎁
Although it is usual to copy the Master branch of repositories on GitHub, the authoring tool is still in pre-release development and testing. The Develop branch is currently the default branch. That's the branch you want and will get using the
git clonecommand below.
git clone https://github.com/adaptlearning/adapt_authoring.git
It is essential that you verify that the MongoDB service has started and is running. Installation will fail if the application cannot connect to MongoDB.
Navigate to the folder where you cloned adapt_authoring and run the following command:
The following and final script will help you configure the authoring tool. Most configuration questions will appear with a default answer already in place. And most times you can just accept the default values by pressing the Enter key. The only input you are required to provide are an email address and password for the super user account. (The questions about the super user account is not the same as the SMTP service or the master tenant.) The super user's email address and password will be used to login to the authoring tool.
FFmpeg is not used by default. When the question "Will ffmpeg be used?" N for no will appear as the default. If FFmpeg is installed and you want to use it, type Y before pressing the Enter key.
In the future the authoring tool will be able to send notifications via e-mail. Configuration questions will ask about SMTP service, SMTP username, SMTP password, and Sender email address. Because this is not yet functioning, your responses have no impact. Accept the default of "none" for the SMTP service and leave the others blank.
Run the following command.
If the script succeeds, you'll receive the following message:
Done, without errors.
And you'll be instructed to
Run the command 'node server' (or 'foreman start' if using heroku toolbelt) to start your instance.
Verify MongoDB service is running.
Run the following command.
As the server starts, it will report in the terminal:
Server started listening on port 5000
If your server is listening on a different port, take note of it.
Open a browser and in the address bar type:
localhost:5000(If your server is listening on a different port, substitute your port for 5000.)
When the login page appears, enter the super user's e-mail address and password.