Skip to content

Troubleshooting

Zulko edited this page Sep 3, 2021 · 9 revisions

Is ReLaXed failing you ? Very sorry. If none of the below works for you, please open an issue on Github.

The installation fails

One possible cause for npm i -g relaxedjs to fail is writing rights in some folders. A simple fix is

sudo npm i -g relaxedjs --unsafe-perm=true

If that didn't work you can also install ReLaXed locally in the folder of your choice. Go to this folder and type in a terminal:

git clone https://github.com/RelaxedJS/ReLaXed.git .
npm install
sudo npm link --unsafe-perm=true

This will provides your system with the relaxed command.

The installation worked, but launching ReLaXed fails

Failure to find module perf_hooks

If you see the error Cannot find module 'perf_hooks', it means that you need a more recent version of Node.js, which bundles this module. Upgrade Node.js and try again.

async function gives "unexpected token"

If you see the code below, it means your node version is too old. Upgrade Node.js and try again.

async function main () {
      ^^^^^^^^
SyntaxError: Unexpected token function

Failure unfound system dependencies

If the failure is linked to un-found dependencies for chromium, have a look at this page. These can also be solved by installing Chromium on your system (~500Mb), if you are on Debian/Ubuntu:

sudo apt-get install chromium-browser

Known issue on ArchLinux

If ReLaXed fails on archLinux with an error saying No usable sandbox! and Received signal 6, try this command to run unprivileged containers:

sudo sysctl kernel.unprivileged_userns_clone=1

If ReLaXed works after this command, you can make the fix permanent as explained here.