Run tests
Run tests locally
Debugtopus will help to run your test locally and debug
Debugtopus is our open source tool enabling you to run tests locally for easier debugging. Follow the steps below to
execute a test case on your machine and against your local dev environment. This is good for setting breakpoints and
stepping through the code once our tests have identified an issue.
Click on 
Now change the url with the url of your locally running application. In the example screenshot below,
the placeholder was replaced with localhost:3000. You might also have to include the route to the starting point.
For example, if your test case assumes to run from the sign-in page you have to add the route to the sign-in page
e.g. localhost:3000/signin.
The biggest portion of this package is Playwright. If you want to see the full package list, please check out
the Debugtopus Github repository.
If you do not have Chromium installed, debugtopus will run npx playwright install chromium for you and the
first run will take some time to complete.
Now the Playwright UI is shown.
Watch this this video for more insight on how to run Octomind tests:
1. Get shell script
Click onrun locally to get a shell script snippet which you can use to install and start Debugtopus.
Run locally button in advanced debugging tools in test result detail, 05/2025
copy to clipboard.
Debugtopus shell script, 05/2025
2. Start test locally
Open a terminal window and paste the shell script from your clipboard.Pasting debugtopus shell script to terminal, 02/2024
Change the url placeholder with your locally running application, 02/2024
3. First time users - install Debugtopus package
If either Playwright or Chromium are not available on your computer, the shell script command will install the Debugtopus package and its dependencies on your computer. You have to confirm by entering y.Install Debugtopus, 02/2024
4. Run test locally in the Playwright UI
Click therun button which is displayed on the right side of the test case to run your test.
Run test button in Playwright UI, 02/2024
Playwright UI screenshot, 02/2024