gon doctor
Check that all required tools are installed and properly configured.
Usage
gon doctor
Sample output
Checking environment... gon-cli v2.4.0PHAR /Users/user/.local/bin/gon.phar848,332 bytesmodified 2026-04-29T14:05:15+00:00Logs /Users/user/.gon/install.log, /Users/user/.gon/selfupdate.log(run gon doctor --logs to tail them) PHP ✓ 8.5.4 (required: ^8.1)Docker ✓ 29.3.1Compose ✓ 5.1.0Docker daemon ✓ runningTraefik ports ✓ 80, 443 boundComposer ✓ 2.9.5MySQL/MariaDB ✓ 8.4.5 (root@127.0.0.1, no password)Git ✓ 2.36.1Node ✓ 22.17.0Yarn ✓ 1.22.19 GitHub auth ✓ (user)Docker disk ✓ 42.6GB freegon.json ✓ (found)gon.lock ✓ (found)
Check performance
Check the performance of your environment.
gon doctor --perf
Sample output
===== gon perf diagnostics =====Run started: 2026-04-29T14:14:29+00:00 ======================================================================Environment======================================================================OS family: DarwinOS release: 25.4.0PHP host: 8.5.4gon-cli: v2.4.0Project: gonProject dir: /Users/user/Works/gonProject URL: https://gon.test/api/v1/healthcheckDocker: 29.3.1 ======================================================================Filesystem benchmark (read first 1KB of 100 files)======================================================================Read 100 files: 12ms total, 0,12ms/fileOK ======================================================================DNS / hosts file======================================================================No hosts entry for gon.testResolve gon.test -> 127.0.0.1 in 2ms ======================================================================HTTP TTFB (5 samples to https://gon.test/api/v1/healthcheck)======================================================================Sample 1: 254msSample 2: 65msSample 3: 62msSample 4: 69msSample 5: 59msmin 59ms, max 254ms, avg 102ms ======================================================================HTTP version negotiation======================================================================* ALPN: curl offers h2,http/1.1* SSL connection using TLSv1.3 / AEAD-CHACHA20-POLY1305-SHA256 / [blank] / UNDEF* ALPN: server accepted h2* using HTTP/2 ======================================================================PHP-FPM response (3 docker exec samples)======================================================================Sample 1: 147msSample 2: 124msSample 3: 124msphp: min 124ms, max 147ms, avg 132ms ======================================================================MariaDB query latency (3 SELECT 1)======================================================================Sample 1: failed (service "database" is not running)Sample 2: failed (service "database" is not running)Sample 3: failed (service "database" is not running) ======================================================================Vite dev server (5 samples to https://gon.test:5173/vite/client)======================================================================Sample 1: 136msSample 2: 8msSample 3: 10msSample 4: 8msSample 5: 6msmin 6ms, max 136ms, avg 33ms ===== diagnostics done =====Send the full output above back to the gon-cli author.
Checks
- PHP 8.1+
- Docker + Docker Compose
- Git
- Composer
- Node.js
- GitHub CLI (
gh)