Skip to content

Updates readme with new gotchas from monday's onboarding difficulties #223

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
lumodon wants to merge 1 commit into
base: master
Choose a base branch
from
Open

Updates readme with new gotchas from monday's onboarding difficulties #223

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
29 changes: 29 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,8 @@ This is the identity management service.

Be sure you've read the [instructions for contributing](./CONTRIBUTING.md).

If you run into errors or problems while getting set up, be sure to check [Gotchas](#gotchas) at the bottom to see if your error is there.

1. **Globally** install [nvm][nvm], [avn][avn], and [avn-nvm][avn-nvm].

```bash
Expand Down Expand Up @@ -220,6 +222,33 @@ When attempting to `npm login`, was seeing `Error: Failed to replace env in conf

`export NPM_AUTH_TOKEN=""`

## React errors

If you're getting React errors or other errors not covered here, maybe you already had IDM installed from a previous time. You need to make sure you're working with a clean copy of idm. You can do the following:
1. if you don't have SSH follow these instructions to set it up: [SSH Setup](https://help.github.com/articles/adding-a-new-ssh-key-to-your-github-account/)
1. type the following commands into your terminal:
```sh
git remote remove origin`
git remote add origin git@github.com:$GITHUB_USER/idm.git
git remote add upstream git@github.com:LearnersGuild/idm.git
git add --all
git stash
git stash drop
git checkout master
git fetch --all
git reset --hard upstream/master
rm -rf node_modules
nvm use
NODE_ENV=development
```

1. You're now done cleaning your IDM, try starting over now.

## Connection Errors

If you can visit `localhost:9001` but not `idm.learnersguild.dev` or are getting odd connection problems, perhaps your mehserve isn't having unique access to port 9001. You may have Apache server running.
Try running this in a terminal `sudo /usr/sbin/apachectl stop`.

## License

See the [LICENSE](./LICENSE) file.
Expand Down