Installeer Nexus Studio en voer je eerste test uit
In zeven stappen ga je van een nieuwe proefperiode naar een geplande testuitvoering. De onderdelen daarna geven de details: download het installatieprogramma, controleer het, activeer deze machine en voer een test uit. De tests draaien op je machine; alleen de licentiecontrole maakt verbinding met buitenaf.
Je eerste 7 minuten
Van een nieuwe proefperiode naar een geplande testuitvoering, in de volgorde die de Studio verwacht. Bij de eerste installatie worden de browsers gedownload, enkele honderden MB, dus de benodigde tijd hangt af van je verbinding.
- Start de proefperiode en installeer. Meld je aan bij je account, accepteer de voorwaarden en start de proefperiode van 30 dagen, zonder betaalkaart. Download het installatieprogramma, controleer de SHA-256-hash, voer het uit en activeer deze machine met je licentiesleutel. Open of maak vervolgens een werkruimtemap en kies Alles installeren in de installatiegids (details).
- Neem je eerste test op (Nexus Recorder). Open in Patrol het tabblad Nexus Recorder, voer de URL voor de opname en een naam voor de test in en kies Opname starten. Doorloop de stappen in het browservenster dat wordt geopend en sluit vervolgens het venster of kies Stoppen & opslaan. De Studio schrijft het testbestand naar je werkruimte. De AI-schrijver en de Test Adapter maken ook tests, als je liever een test beschrijft of een bestaande test importeert.
- Oefen in de sandbox (3 uitvoeringen). Kies na het opslaan van de opname Uitvoeren in sandbox, met browservenster. Een sandboxuitvoering slaat niets op in het bewijsmateriaal of de geschiedenis, en elk van de drie oefenuitvoeringen gebruikt een andere browser. De kaart Wachten om de sandbox te verlaten in Patrol telt ze van 0/3 tot 3/3, waarna de test naar Klaar voor de eerste echte uitvoering gaat. API-tests hebben geen sandbox: ze worden bij de eerste klik meteen echt uitgevoerd.
- Eerste echte uitvoering. Selecteer de test op het tabblad Patrol uitvoeren, laat sandbox uitgevinkt en kies Patrol echt uitvoeren. Een echte uitvoering slaat gegevens op in het bewijsmateriaal en de geschiedenis. Playwright-tests draaien op Chromium, Firefox en WebKit, en Selenium-tests op Chromium en Firefox.
- Lees het oordeel. Patrol geeft elke test een kleur op basis van de status in elke browser, en de uitvoeringsbalk boven de editor beschrijft wat elke browser doet. De status is een van 14 oordelen: SECURE is direct geslaagd, FLAKY is pas bij een nieuwe poging geslaagd, BREACHED is een echte bevinding en TIMEOUT gaf niet op tijd antwoord, wat niet bewijst dat er iets defect is.
- Open het bewijsmateriaal. Kies in de menubalk Beeld en vervolgens Bewijskluis. Elk dossier bevat Rapport, Metadata, Telemetrie en Ruw logboek. Markeer een mislukking als Echte fout of Vals alarm, met een reden: het eerste oordeel vormt het begin van de bewijsketen, en Verifiëren vermeldt het eerste dossier dat is gewijzigd.
- Plan het in (Bewaken of CI/CD). Bewaken, op het tabblad Patrouille uitvoeren, voert een selectie automatisch opnieuw uit volgens een tijdschema: elke 5 minuten tot 24 uur, of eenmalig op een datum. De machine waarop Studio draait moet aanstaan. Als je Telegram of Slack koppelt, krijg je daar alleen een melding wanneer een status verandert. Kies voor een pijplijn Uitvoeren en vervolgens Omgevingen & CI/CD: het scherm maakt het GitHub Actions- of GitLab CI-bestand aan (Voer je tests uit via CI/CD). Een machine die de engine in CI uitvoert, is een geactiveerde machine en telt mee voor je abonnement.
Systeemvereisten
Op Windows 11 x64 met 16 GB RAM is het installatieprogramma alles wat deze machine nodig heeft om Playwright-tests uit te voeren. Elke rij met de aanduiding Optioneel is alleen nodig voor de genoemde functie en wordt gecontroleerd via het instellingenscherm van de Studio.
| Onderdeel | Status | Details |
|---|---|---|
| Windows 11 x64 | Vereist | Nexus Studio is een Windows-bureaubladtoepassing. Elke geactiveerde machine telt mee voor je abonnement: 1 bij de proefversie, 1 bij Individual, 3 bij Team, 10 bij Business (abonnementen en machines). |
| Geheugen | Vereist | Minimaal 16 GB RAM. Windows, de Studio en de browsers delen dit geheugen. Volgens de eigen schatting van de engine heeft elke browser ongeveer 0.5 GB vrij geheugen nodig en blijft er nog 1 GB vrij voor Windows en de Studio: drie browsers tegelijk hebben ongeveer 2.5 GB vrij geheugen nodig. |
| Schijfruimte | Vereist | Gemeten: 207 MB voor de Studio, de engine en de bijbehorende pakketten in de build van 2026-09-22, voordat Node.js aan het installatieprogramma werd toegevoegd; 1.2 GB voor de browsers van Playwright 1.62.1 (Chromium, Chromium headless shell, Firefox, WebKit en ffmpeg). Je werkruimten en bewijsmateriaal komen daar nog bij. |
| Internet | Vereist | Voor de licentiecontrole: bij activering, daarna elke 24 uur. Zonder controle blijft de Studio 7 dagen werken, toont vervolgens nog 4 dagen een melding en schakelt daarna over naar alleen-lezen totdat er weer verbinding is (offline werken). Je hebt ook een account met een proefversie of abonnement nodig; voor de proefperiode van 30 dagen is geen betaalkaart nodig. |
| Nexus Studio en de engine | Meegeleverd | De desktopapp en de engine die je testsuites uitvoert, met de pakketten van de engine. |
| Node.js 24 LTS | Meegeleverd | De engine draait op de kopie in het installatieprogramma. Je hoeft Node.js niet te installeren. |
| Playwright 1.62.1 | Meegeleverd | Het programma dat de tests uitvoert. |
| Playwright-browsers | Automatisch geïnstalleerd | Chromium, Firefox en WebKit voor Playwright 1.62.1 worden eenmalig gedownload vóór de eerste lokale uitvoering, waarvoor dus internet nodig is. Daarna werkt de werkruimte offline, behalve voor de licentiecontrole. |
| Python 3.10 of hoger | Optioneel: Python | Voor pytest-testsuites, Selenium voor Python, de Test Adapter voor .py-bestanden en Recorder-uitvoer in Python. Het installatiescherm controleert de versie en installeert met één klik pytest, pytest-playwright, selenium en playwright via pip, en de Playwright-browsers voor Python. |
| Eclipse Temurin JDK 17 | Optioneel: Java | Voor Selenium-tests met JUnit 5, gebouwd met Maven. Het installatiescherm controleert de JDK- en Maven-versies en installeert de JDK met één klik via winget. Gemeten: 313 MB op schijf, 180 MB RAM voor één test. |
| .NET SDK 10 | Optioneel: C# | Voor Selenium- en Playwright-tests met NUnit. Het installatiescherm controleert de SDK-versie en installeert de SDK met één klik via winget. Gemeten: 770 MB op schijf, 261 MB RAM voor één test. |
| Google Chrome | Optioneel: Selenium | Selenium 4.45.0 voor JavaScript stuurt Chrome aan; Selenium Manager zoekt het bijbehorende stuurprogramma, waarvoor bij de eerste download internet nodig is. Firefox is een alternatief, maar is nog niet in de praktijk getest. Edge en WebKit worden niet ondersteund voor Selenium. |
| adb en scrcpy | Optioneel: Android | adb voor fysieke Android-telefoons via USB; scrcpy is optioneel. Het installatiescherm installeert beide via winget. USB-foutopsporing moet ingeschakeld zijn: Apparaten & mobiel bevat een handleiding voor de eerste telefoon. |
| Docker Desktop | Optioneel: Docker-uitvoeringsomgeving | Met de WSL 2-backend en Compose v2, en een Docker-VM met minimaal 4 GB geheugen. De containerimage voor de testuitvoering is gebaseerd op mcr.microsoft.com/playwright:v1.62.1-noble (Ubuntu 24.04). |
| OpenSSH Client | Optioneel: SSH-uitvoeringsomgeving | De optionele Windows-functie, onder Instellingen, Systeem, Optionele onderdelen. |
| A VPS | Optioneel: externe uitvoeringsomgeving | Ubuntu 24.04 LTS x86_64 met Docker Engine en Compose v2, bereikbaar via SSH-sleutelverificatie. De engine voert je testsuites daar uit in dezelfde containerimage. |
Download het installatieprogramma
- Open Downloaden en kies Downloaden voor Windows. De pagina toont de versie, de releasedatum, de grootte en de SHA-256. Hetzelfde installatieprogramma staat onder Downloads in je account.
- Nog geen licentie? Meld je aan bij je account, met je e-mailadres of met Google, en accepteer op Overzicht de voorwaarden en start de proefperiode van 30 dagen. De 30 dagen beginnen pas wanneer je de Studio activeert.
De download controleren
De SHA-256 op de downloadpagina is de vingerafdruk van het installatieprogramma dat we hebben gepubliceerd. Vergelijk deze met het bestand dat je hebt gedownload voordat je het uitvoert. In PowerShell, vanuit de map met het bestand:
(Get-FileHash -Algorithm SHA256 ".\<installer file name>").Hash -eq "<SHA-256 from the Download page>"
True betekent dat het bestand door ons is gepubliceerd; hoofdletters maken niet uit. False betekent dat dit niet zo is: verwijder het, download het opnieuw, en voer het niet uit.
Windows SmartScreen kan een nieuw installatieprogramma tegenhouden met de melding “Uw pc wordt beschermd”. Ga alleen verder als de controle True aangeeft: kies Meer informatie, en vervolgens Toch uitvoeren.
Activeer deze machine
- Voer het installatieprogramma uit en open daarna Nexus Studio.
- Kopieer je licentiesleutel. Je account toont deze één keer: direct nadat je de proefperiode start, of wanneer je bij een betaald abonnement Licentiesleutel ophalen kiest onder Licentie & computers. We bewaren alleen een hash ervan, dus als je de sleutel kwijtraakt, moet je een nieuwe genereren.
- Zolang de Studio niet is geactiveerd, opent deze met het scherm Licentie. Plak de sleutel in het veld voor de licentiesleutel en kies Activeren. De sleutel begint met
nxs_live_en is 61 tekens lang; spaties en regeleinden die bij het kopiëren zijn meegekomen, worden genegeerd. - De status is Actief. Bij een proeflicentie beginnen de 30 dagen nu.
De sleutel wordt één keer verzonden om deze computer te activeren, en de Studio bewaart deze niet. Vanaf dat moment bevestigt de Studio zelfstandig de licentie. Op hetzelfde scherm staat onder Wat deze computer verlaat het exacte verzoek dat bij de volgende controle wordt verzonden (wat het bevat).
Als de activering wordt geweigerd, vermeldt het bericht waarom: de sleutel is ongeldig, alle computers binnen het abonnement zijn in gebruik, op deze computer is al een proeflicentie gebruikt, de licentie is niet volledig betaald of de licentieserver is niet bereikbaar.
Open een werkruimte en voer de configuratie uit
Dit deel vindt plaats op je computer, en wij krijgen het nooit te zien: de test niet, en het resultaat ook niet.
- Open een map. Je tests en bewijsmateriaal staan samen in één werkruimtemap. Kies Nieuwe map en Hier aanmaken, of Bestaande openen voor een map die al een werkruimte is.
- Configuratie. De werkruimte installeert de pakketten en browsers eenmalig, met npm install en playwright install. In de configuratiegids voert Alles installeren de nog ontbrekende stappen één voor één uit, en wordt Doorgaan beschikbaar zodra elke vereiste rij gereed is. Hiervoor is een netwerkverbinding nodig; daarna werkt de werkruimte offline, afgezien van de licentiecontrole. adb is alleen nodig voor echte Android-telefoons.
- Dan de test zelf. Maak de test, oefen ermee, voer hem echt uit en lees het oordeel: stappen 2 tot 6 van Je eerste 7 minuten.
De rondleiding door de Studio laat elk scherm zien.
Updates
Updates worden nooit automatisch uitgevoerd: er wordt niets gedownload of geïnstalleerd totdat je Nu bijwerken kiest. Daarna is één klik voldoende.
- Wanneer een nieuwere versie wordt gepubliceerd, toont de Studio een regel onder de menubalk: Nexus Studio en het versienummer, is beschikbaar, met Nu bijwerken en Later. De melding wordt ondertekend meegestuurd bij de licentiecontrole; de Studio toont niets voor een update die niet kan worden geverifieerd.
- Er wordt niets gedownload totdat je Nu bijwerken kiest. Studio downloadt vervolgens het installatieprogramma via HTTPS van downloads.sentinel-nexusstudio.com en controleert de SHA-256 aan de hand van de ondertekende melding. Voor de melding is geen aparte verbinding nodig, en de download is de enige verbinding naast de licentiecontrole.
- Als de controle slaagt, sluit Studio en wordt de nieuwe versie geïnstalleerd zonder vragen, met alleen een voortgangsbalk. Daarna wordt Studio opnieuw geopend. Als de controle mislukt, wordt het bestand verwijderd en wordt er niets geïnstalleerd. De statusregel vermeldt de reden en biedt Opnieuw proberen aan.
- Na de update wordt de kopie van de engine in elke werkruimte automatisch bijgewerkt naar de nieuwe versie. Je tests, bewijsmateriaal en instellingen blijven ongewijzigd.
Waar je het kunt draaien
De Studio draait op je eigen Windows 11-pc, en verder is er niets nodig.
- Je eigen pc. Installeer de Studio, open een werkruimte en voer je tests uit. Geplande uitvoeringen vinden alleen plaats als de pc niet in de slaapstand staat.
- Een mini-pc, optioneel. Een aparte Windows 11-computer die aan blijft staan, voor nachtelijke regressietests en geplande uitvoeringen zonder een werkstation bezet te houden. Watch houdt zich aan de planning, en het bewijsmateriaal blijft op de schijf van die computer.
- Een runtime per werkruimte. Voor elke werkruimte kies je op het Docker-scherm van de Studio waar de engine de testsuites uitvoert: deze machine; Docker op deze machine, in de runnercontainer op dezelfde schijf; of een VPS via SSH, met dezelfde containerimage. Twee te testen applicaties in twee werkruimten kunnen twee verschillende runtimes gebruiken. Geen van de drie is verplicht, en wisselen kan met één instelling. De Studio zelf blijft altijd op Windows.
- Een VPS draait op Ubuntu 24.04 LTS met Docker Engine en Compose v2 en is bereikbaar via authenticatie met een SSH-sleutel. Het bewijsmateriaal blijft daar totdat je het ophaalt. De VPS controleert zijn eigen licentie en telt mee als een machine binnen je abonnement: zie abonnementen en machines.
- Echte Android-telefoons sluit je via USB aan op de computer waarop de Studio draait, met USB-foutopsporing ingeschakeld; Apparaten & mobiel bevat een handleiding voor de eerste telefoon. Tests op telefoons, Selenium- en Python-testsuites en infrastructuur-chaostests draaien altijd op de computer waarop de Studio zelf draait.
Watch, de taakplanner, draait alleen op de machine van de Studio zelf, met de runtime van de werkruimte ingesteld op Local. Gebruik je CI om testuitvoeringen op een VPS te plannen: Voer je tests uit vanuit CI/CD.
Beheer je eigen infrastructuur helpt je kiezen tussen deze opstellingen, en vergelijkt eigen computers met een QA-platform in de cloud en een gehuurde server: waar het bewijsmateriaal staat, wie er toegang toe heeft en wat het kost.
Hoe test Nexus Studio localhost zonder tunnel?
Je eigen QA-apparaat. Geen tunnel, geen openbaar toegankelijke staging-URL, geen testgegevens die je netwerk verlaten. Draait op Windows 11, Ubuntu 24.04 LTS, Docker of SSH. BASE_URL richt de testsuite op je app op localhost of op een privé-staging-URL, zonder aanpassingen.
- Een ontwikkelserver die na de tests blijft draaien.
NEXUS_APP_STARTstart je app vóór elke uitvoering en stopt deze met de volledige procesboom wanneer de uitvoering eindigt, mislukt of wordt onderbroken, ook bij Ctrl+C. - Een geslaagde uitvoering tegen een app die nooit is gestart.
De uitvoering wacht totdat de gereedheids-URL antwoordt met een status lager dan 500, en controleert dit elke 0.5 s. Als de app niet kan starten, begint de uitvoering nooit:
CONFIG_ERROR APP_DID_NOT_START, met de laatste 40 logregels. - Een tweede exemplaar van een app die al draait.
NEXUS_APP_REUSE=truegebruikt een app die al antwoordt en laat deze draaien;falsestopt de uitvoering als daar iets anders antwoordt. - Een resultaat dat niemand aan een build kan koppelen.
Elke uitvoering legt de versie uit package.json van je app vast, samen met de geteste git-commit.
- Docker en SSH.
In Docker draait de app nog steeds op deze machine en bereikt de container een localhost-BASE_URL via host.docker.internal. Via SSH start de app op de externe host.
Eén programma met de bijbehorende argumenten, zonder shell: npm run dev, pnpm dev of node server.js. nexus app check, Testen in de Studio, start de app, wacht en stopt deze. Het volledige logboek blijft bewaard in evidence/run-context/.