Troubleshooting

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 to 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 main: Unexpected token function

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.