Installation Guide Dec 2024

[DeepSeaCatz]

I've had many issues getting the new version going, so I'm writing a guide on the current way of installing Adapt Authoring for everyone else that are struggling.

Adapt_authoring 0.11.4 Adapt framework 5.41.13

Prerequisite

Node v18.20.5 (can be installed with nvm) https://nodejs.org/en/blog/release/v18.20.5

(Optional) Nvm v1.1.12 (I had an issue with npm giving errors when calling it with node v18 when I've installed with with nvm v1.1.7. Using most recent version fixed it (https://github.com/nodejs/help/issues/3709) https://github.com/coreybutler/nvm-windows/releases/tag/1.1.12

Mongodb v8.0.4 https://www.mongodb.com/try/download/community

1. Run the MSI and finish all steps with optional of installing MongoDB Compass

2. Search Edit the system environment variables on windows search

3. Under Advanced tab, bellow select Environment Variables

4. Double Click on Path and select New and enter all possible path (I may not be correct here, but I shove all possibilities just in case because it let you use npm and nvm in the cmd everywhere):

   • C:\Program Files\MongoDB\Server\8.0\bin
   • C:\Users\YouUserName\AppData\Roaming\npm

   If you installed nvm:

   • C:\Users\YouUserName\AppData\Roaming\nvm
   • C:\Users\YouUserName\AppData\Roaming\nvm\v18.20.5

Adapt Installation

1. Under C:\ drive, create a folder called adapt
2. Open cmd prompt and go to the path cd C:\adapt
3. Write git clone https://github.com/adaptlearning/adapt_authoring
4. Write cd adapt_authoring to go inside the new folder
5. Write npm install
6. Write npm install [email protected] https://github.com/adaptlearning/adapt_authoring/issues/2504
7. Write node install
8. During the installation, change the default localhost to 127.0.0.1 (From what I understand, MongoDB seems to not be compatible with node v17.x or later as it should be listening on IPv6”::1”. If you keep localhost, you’ll get a “connect ECONNREFUSED” error when starting the server). Use default options for everything else by pressing Enter.

9. After this step, when you’ll see the option in the cmd that ask an email for Super Admin, you can enter a short regular name for easier access (it’ll be your username login for the Super Admin). All other usernames will be emails when creating it on the adapt user manager.
10. Write node server in the cmd. Every time you'll want to start the Adapt server, it'll be this command inside adapt5/adapt_authoring folder by using cmd.
11. Connect to http://127.0.0.1:5000/ on your browser and login with the same Super Admin access you entered in the cmd during the installation. You can create new users with different privilege in the User tab after you're in.
12. If you’re receiving errors about node_modules/express package in the cmd after logging in and creating/editing a course, re-install mongoose version 5.8.13 by writing this in the cmd: npm install [email protected].

I hope this help someone out there.