Oxid Documentation

Oxid is a standalone infrastructure-as-code engine - an open-source alternative to Terraform and OpenTofu. It parses HCL (.tf) files natively, communicates directly with providers via gRPC, and stores state in SQLite or PostgreSQL.

Why Oxid?

  • No Terraform binary needed. Oxid reads your .tf files directly and talks to AWS, GCP, Azure providers over gRPC.
  • Event-driven parallelism. Resources start the instant their dependencies complete - no wave-based batching.
  • SQL-queryable state. Your state lives in SQLite (local) or PostgreSQL (teams). Query it with full SQL.
  • Resource change history. Every create, update, and delete is recorded with full attribute snapshots for audit trails.
  • Blast radius analysis. See exactly what breaks before you change anything - forward and reverse dependency analysis.
  • Encrypted sensitive outputs. AES-256 encryption at rest for sensitive values in PostgreSQL via pgcrypto.

Quick Start

Install
curl -fsSL https://raw.githubusercontent.com/ops0-ai/oxid/main/install.sh | bash
Initialize, plan, apply
cd your-terraform-project/
oxid init          # Download providers, create state DB
oxid plan          # Preview changes
oxid apply         # Apply infrastructure

Core Concepts

Oxid follows the same workflow as Terraform - init → plan → apply - but with key differences under the hood:

HCL Parsing

Your existing .tf files work unchanged. Oxid uses hcl-rs to parse them natively.

Provider Protocol

Direct gRPC communication with providers using tfplugin5/6 protocol.

State Backend

SQLite for local dev, PostgreSQL for teams. Full SQL query support.

DAG Execution

Event-driven parallel execution with configurable concurrency.

All Commands

oxid initInitialize providers and state databaseoxid planPreview infrastructure changesoxid applyApply infrastructure changesoxid destroyDestroy all managed resourcesoxid stateInspect and manage stateoxid importImport existing resourcesoxid syncSync state from Terraform backendoxid querySQL queries against stateoxid outputShow output valuesoxid blast-radiusImpact analysis for changesoxid historyResource change audit logoxid driftDetect configuration driftoxid graphDependency graph visualizationoxid validateValidate configurationoxid watchWatch Terraform/OpenTofu JSON output for observability