Troubleshooting

This guide aims to provide solutions to some common issues you may encounter while developing with Rocket.Chat, such as missing npm packages, warnings in meteor logs, and Python interpreter version mismatches.

• babel-runtime:

If you encounter an error stating:

(STDERR) Error: The babel-runtime npm package could not be found in your node_modules
(STDERR) directory. Please run the following command to install it:
(STDERR)
(STDERR)   meteor npm install --save babel-runtime
(STDERR)
(...)
=> Exited with code: 1
=> Your application is crashing. Waiting for file change.

you can resolve this by installing the mentioned package with the command:

meteor npm install --save babel-runtime

• bcrypt:

If you see the following warning in the meteor logs:

(STDERR) Note: you are using a pure-JavaScript implementation of bcrypt.
(STDERR) While this implementation will work correctly, it is known to be
(STDERR) approximately three times slower than the native implementation.
(STDERR) In order to use the native implementation instead, run
(STDERR)
(STDERR)   meteor npm install --save bcrypt
(STDERR)

This simply means that the bcrypt library is not installed on your system and meteor will use a JavaScript alternative that is about three times slower.

To install the library and make it faster, use the command:

meteor npm install --save bcrypt

If the version of the python interpreter on your system is greater than v2.5.0 or less than 3.0.0, it should work fine, but, if you see a message like this:

gyp ERR! configure error
gyp ERR! stack Error: Python executable "/usr/local/bin/python3" is v3.5.2, which is not supported by gyp.
gyp ERR! stack You can pass the --python switch to point to Python >= v2.5.0 & < 3.0.0.

After you are sure that you have a python interpreter that matches the above requirements, use the following command to fix the error:

meteor npm config set python python2.7

Build it again:

meteor npm install --save bcrypt

If everything works, you should see a message like this:

> node-gyp rebuild

  CXX(target) Release/obj.target/bcrypt_lib/src/blowfish.o
  CXX(target) Release/obj.target/bcrypt_lib/src/bcrypt.o
  CXX(target) Release/obj.target/bcrypt_lib/src/bcrypt_node.o
  SOLINK_MODULE(target) Release/bcrypt_lib.node
clang: warning: libstdc++ is deprecated; move to libc++ with a minimum deployment target of OS X 10.9
Rocket.Chat@0.46.0-develop /Users/douglas/work/github/Rocket.Chat
└─┬ bcrypt@0.8.7
  ├── bindings@1.2.1
  └── nan@2.3.5

Troubleshooting is a vital part of the development process, and understanding how to navigate and resolve common issues can significantly enhance your productivity. This guide provides solutions to some common Rocket.Chat development problems, but remember, each issue is unique, and sometimes, you may need to dig deeper to find the root cause.