Skip to main content

​
What is envcheck?

envcheck is a fast, lightweight CLI tool written in Rust that validates development environments against project requirements. It eliminates “works on my machine” problems by ensuring everyone on your team has the right tools, versions, and configurations before they start working.

​
The Problem

How many times have you encountered these scenarios?
  • A new developer joins your team and spends hours installing dependencies
  • Your CI pipeline fails because a developer’s local environment differs from production
  • A critical bug only appears in certain environments due to version mismatches
  • Team members forget to set required environment variables
These issues waste valuable development time and create frustration across teams.

​
The Solution

With envcheck, you define your environment requirements once in a .envcheck.yaml file, and everyone can validate their setup in seconds: 
$ envcheck

Running environment checks...

✓ node 18.17.0 found
✓ docker found
✗ DATABASE_URL is not set
  Set DATABASE_URL environment variable
✓ Port 3000 is available
✓ .env exists

--- 1 issue(s) found. Fix them to continue.

​
Key Features

Fast

Written in Rust, compiled to a single binary with zero runtime dependencies. Validation completes in milliseconds.

Simple

Just add a .envcheck.yaml file to your project. No complex configuration or setup required.

Comprehensive

Validates tools, versions, environment variables, ports, files, directories, and network connectivity.

Cross-platform

Works seamlessly on macOS, Linux, and Windows without any platform-specific tweaks.

​
What Can You Check?

​
Tools and Versions

Verify that required development tools are installed with proper version constraints using semver: 
tools:
  - name: node
    version: ">=18.0.0"
    required: true
  - name: docker
    required: false
Supported tools include node, npm, go, rust, cargo, python, docker, git, java, ruby, and more.

​
Environment Variables

Ensure critical environment variables are set and optionally match specific patterns: 
env_vars:
  - name: DATABASE_URL
    required: true
  - name: NODE_ENV
    pattern: "^(development|test|production)$"
    required: true

​
Ports

Check that required ports are available before starting services: 
ports:
  - 3000
  - 5432

​
Files and Directories

Validate file existence, permissions, and directory structure: 
files:
  - path: .env
    required: true
    permissions: 0o600
  - path: storage/logs
    is_directory: true
    required: true

​
Network Connectivity

Verify connectivity to critical services: 
network:
  - url: https://github.com
    status_code: 200

​
Use Cases

New team members can quickly validate their setup matches the project requirements. Instead of a lengthy setup document, they run envcheck and get immediate, actionable feedback.
Add envcheck to your CI/CD pipeline to catch environment issues early. Export results to JSON with --json flag for easy integration.
Run envcheck in Git hooks to ensure developers have the correct environment before committing code.
Each service can have its own .envcheck.yaml to validate service-specific requirements independently.

​
Clean, Actionable Output

envcheck provides clear, colored terminal output with helpful suggestions when checks fail:
  • ✓ Green checkmarks for passing validations
  • ✗ Red X marks for failures with actionable error messages
  • Summary of total issues found
  • Exit code 0 for success, non-zero for failures (perfect for scripts)

​
Next Steps

Install envcheck

Get envcheck installed on your system

Quick Start

Run your first environment check in minutes