gon doctor

Check that all required tools are installed and properly configured.

Usage

gon doctor

Sample output

Checking environment...
 
gon-cli v2.4.0
PHAR /Users/user/.local/bin/gon.phar
848,332 bytes
modified 2026-04-29T14:05:15+00:00
Logs /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.1
Compose 5.1.0
Docker daemon running
Traefik ports 80, 443 bound
Composer 2.9.5
MySQL/MariaDB 8.4.5 (root@127.0.0.1, no password)
Git 2.36.1
Node 22.17.0
Yarn 1.22.19
 
GitHub auth (user)
Docker disk 42.6GB free
gon.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: Darwin
OS release: 25.4.0
PHP host: 8.5.4
gon-cli: v2.4.0
Project: gon
Project dir: /Users/user/Works/gon
Project URL: https://gon.test/api/v1/healthcheck
Docker: 29.3.1
 
======================================================================
Filesystem benchmark (read first 1KB of 100 files)
======================================================================
Read 100 files: 12ms total, 0,12ms/file
OK
 
======================================================================
DNS / hosts file
======================================================================
No hosts entry for gon.test
Resolve gon.test -> 127.0.0.1 in 2ms
 
======================================================================
HTTP TTFB (5 samples to https://gon.test/api/v1/healthcheck)
======================================================================
Sample 1: 254ms
Sample 2: 65ms
Sample 3: 62ms
Sample 4: 69ms
Sample 5: 59ms
min 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: 147ms
Sample 2: 124ms
Sample 3: 124ms
php: 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: 136ms
Sample 2: 8ms
Sample 3: 10ms
Sample 4: 8ms
Sample 5: 6ms
min 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)