Picture of Simon Date
Installing the AT on AWS C9
by Simon Date - Thursday, 24 May 2018, 3:39 PM

AWS C9 is a IDE that sits on top of Amazon Web Services. You can use this Platform as a Service (PaaS) to host the Adapt Authoring Tool on a server that you and your team can access anywhere.

Once you have AWS C9 setup this process is perhaps even easier than installing the Authoring Tool locally as Git and Node are already pre-installed on the Development Environment. This wiki entry was based of an existing AWS and Mongodb setup guide as well as Stephen Harlow's guide on Youtube - https://www.youtube.com/watch?v=sDlwR8WMpt4

Please note: this guide is not intended for serious production or dev use.

Create an AWS account

- Sign up here
- Select Personal for account type
- AWS requires a valid phone number for verification
- Your credit/debit card will also be charged $1 for verification purposes, the amount will be refunded after being processed
- See here for more information about the charge
- Select the Free Basic Plan
- This plan is free for 12 months with certain usage restrictions, set a date in your calender to cancel your plan if you don't want to be charged after one year
- See more details about the free plan here
- Sign in to the AWS console with your new account
- It can take up to 24 hours for your account to be verified, check your email for notification
- Once logged in you'll be in the AWS dashboard
- Click the Cloud9 link, otherwise type cloud9 into the AWS services search bar and select Cloud9 A Cloud IDE for Writing, Running, and Debugging Code
- If your account has been verified then you will be able to select Create environment
- Name it wdb and click Next step
- Leave default settings and click Next step again
- Scroll down and click Create environment

Install MongoDB

Enter touch mongodb-org-3.6.repo into the terminal
Now open the mongodb-org-3.6.repo file in your code editor (select it from the left-hand file menu) and paste the following into it then save the file:

name=MongoDB Repository

Now run the following in your terminal:

sudo mv mongodb-org-3.6.repo /etc/yum.repos.d
sudo yum install -y mongodb-org
- Close the mongodb-org-3.6.repo file and press Close tab when prompted
- Change directories back into root ~ by entering cd into the terminal then enter the following commands:

mkdir data
echo 'mongod --dbpath=data --nojournal' > mongod
chmod a+x mongod

- Run ./mongod to start the server.

# Download & install the Authoring Tool

- Open a new terminal by pressing the + icon and selecting new terminal
- Run git clone https://github.com/adaptlearning/adapt_authoring.git to download the Authoring Tool
- Once downloaded run npm install to install Node modules
- Run node install to install the application.
- At the first option use port 8080 instead of  5000
- Keep the rest of the options default
- After going through the options the Authoring Tool will install. If everything went correctly you will receive a message confirming it was successful
- Run node server to start the Authoring Tool.
- Click on the Preview tab and select preview running application.
- The Authoring Tool should open in a tab next to your console. Copy the URL to a new browser if you wish to use full screen.


Picture of Fabio Beoni
Re: Installing the AT on AWS C9
by Fabio Beoni - Thursday, 24 May 2018, 6:40 PM

Hi Simon,


nice tutorial, thanks for it. One of my team did a test of Adapt on AWS but I don't think was by Cloud9... I think C9 was still a in beta.

Cheers, Fabio.

Picture of Caleb Foster
Re: Installing the AT on AWS C9
by Caleb Foster - Friday, 25 September 2020, 7:53 AM

Hello Simon

Could you let me know if these steps are still valid, as I'm getting a number of errors when trying this. Appreciate this is quite a dated post.

Many thanks


Picture of Simon Date
Re: Installing the AT on AWS C9
by Simon Date - Friday, 25 September 2020, 10:40 AM

Hi Caleb,

I haven't used C9 for a while so I can't really confirm/deny this will work.

Adapt user Stephen Harlow actually created a video today which explains how to install the tool in an visual, intergrated environment similar to C9.



Edit - I just noticed he already shared it!