Troubleshooting

We've collected the most commonly-experienced problems users have here along with their solutions. If there's anything you'd like to see added here, you're welcome to edit this page yourself, or you can head to the documentation room on Gitter, where someone will be happy to help.

• I'm locked out of my account
• How do I change my password?
• How do I change my e-mail address?
• I receive a ECMDERR error during install

---

I'm locked out of my account

If you enter the incorrect password 3 times, you will be locked out of your account. To rectify this, you will need to edit the database directly (if you've forgotten your password, see below).

See our page on accessing the database for more information.

1. Get into the users collection.
2. Find the document for your user.
3. Change the failedLoginCount value to 0.

Back to Top

---

How do I change my password?

If you're able to access the tool, you can change the password for your account by clicking on your e-mail address in the top navigation. This will bring up your user profile page, which contains a form for changing passwords.

If you can't access the tool, you'll need to modify the database directly (Warning: requires the command line):

1. Connect to the database (see our page on accessing the database for steps on doing this).
2. Access the users collection.
3. Find the document for your user.
4. Generate a new password hash (for steps on how to do this, have a look at this page).
   N.B. in the interests of security, we only store hashed representations of user passwords (see this Wikipedia article for some background reading).
5. Add the generated value to your user document.

Back to Top

---

How do I change my e-mail address?

To do this, you'll need to change the user's document in the database.

See our page on accessing the database for more information.

1. Access the users collection.
2. Find the document for your user.
3. Update the email value with the new address.

Back to Top

---

I receive a ECMDERR error during install

Failed to execute "git ls-remote --tags --heads git://github.com/adaptlearning/adapt-contrib-vanilla.git"

If you get something similar to the above error during install, you likely have a problem connecting to GitHub via the git:// protocol.

To fix this, you can use the url.<base>.insteadOf configuration option to make git perform remote operations over https rather than git:

git config --global url."https://".insteadOf git://

Back to Top