Device Tests

Lightweight Chromebook hardware tests built with plain HTML, CSS, and JavaScript.

Run with Docker Compose

docker compose up -d --build

The site will be available on port 8080 by default. Change the host port with:

DEVICE_TESTS_PORT=8090 docker compose up -d --build

Nginx Proxy Manager

Create a Proxy Host with:

• Domain Names: your chosen internal or public hostname
• Forward Hostname / IP: the Docker host's reachable IP, or device-tests when Nginx Proxy Manager shares the same Docker network
• Forward Port: 8080 (or the value of DEVICE_TESTS_PORT)
• Websockets Support: not required

The camera test needs browser permission and normally requires HTTPS, except on localhost. In Nginx Proxy Manager, enable an SSL certificate for the hostname before using camera access.

ChromeOS performance

The site has no framework or runtime dependencies. Media tests request modest camera resolution, microphone analysis uses a small audio buffer, screen redraws are limited during resize, and the audio context is reused between speaker checks to reduce memory and CPU use on low-memory Chromebooks.