Skip to content

Troubleshooting setup

When the wizard or the verify step has not yet seen your first event, it names the cause and the next step – never a generic error.

Run the check again and it prints the cause it found:

Terminal window
npx xovris@latest verify
Email support with what it printed

These are the problems it recognises.

The key is wrong, or it was switched off. Setting up again replaces the key in your env file.

Run the setup again:

Terminal window
npx xovris@latest init

Events are blocked before they leave your machine

Section titled “Events are blocked before they leave your machine”

The ingest address did not resolve, the connection was refused or timed out, or the secure connection failed. Allow outbound HTTPS to the ingest address in your firewall or proxy.

Then check again:

Terminal window
npx xovris@latest verify

A browser extension blocked browser events

Section titled “A browser extension blocked browser events”

An ad blocker stopped the request to the ingest address. Server events still arrive; browser events need to be sent through your own domain.

Your framework version is outside the supported range

Section titled “Your framework version is outside the supported range”

The wizard stops before changing anything and names the range its changes are written for. Upgrade the framework to a version in that range and run it again. Each stack’s range is on its own page under Connect your app.

Your Node.js version is older than the SDK needs

Section titled “Your Node.js version is older than the SDK needs”

The diagnosis names the supported range. Upgrade Node.js to a version in that range and run the wizard again.

Your production build ran without the source-map upload token. Run the wizard again in the project to add the build token to your platform.

Ask Xovris

Open the full page

Your data is never used to train our AI. How your data is kept

A problem is called fixed only once it works again. How each fix is checked

XOVRIS LTD, registered in England and Wales, company number 17499910. Registered office: 66 Paul Street, London EC2A 4NA.