dotEnv

Documentation

Everything you need to get up and running with DotEnv

Getting Started

Install the CLI, create your first project, and pull your first secrets.

Set Up DotEnv with an AI Agent

9 min read

Installation

3 min read

Quick Start

3 min read

Your First Project

3 min read

Environments & Cascading

3 min read

Team Setup

3 min read

Core Concepts

How DotEnv is organized — the hierarchy, secret inheritance, and security model.

How DotEnv Works

4 min read

The DotEnv Hierarchy

4 min read

Secret Inheritance

3 min read

Security Model

3 min read

Access Control

4 min read

Web App

Manage organizations, projects, secrets, keys, and teams from the dashboard.

Web Dashboard Overview

3 min read

Organizations

3 min read

Projects, Targets & Environments

3 min read

Managing Secrets

3 min read

Secret Versioning

2 min read

Encryption Keys

3 min read

API Keys

3 min read

Teams & Members

2 min read

Account & Security

3 min read

Notifications & Activity

2 min read

Billing & Plans

3 min read

API

The HTTP API — endpoints, authentication, scopes, and worked examples.

API Overview

3 min read

Authentication

4 min read

Errors

2 min read

Rate Limiting & Pagination

2 min read

Organizations

3 min read

Projects, Targets & Environments

4 min read

Secrets

4 min read

Secret Versions

4 min read

Encryption Keys

5 min read

API Keys

3 min read

Billing

4 min read

CLI

Install, authenticate, and drive DotEnv from the command line.

CLI Overview

3 min read

Installation

2 min read

Authentication

3 min read

Command Reference

8 min read

Pulling and Pushing

4 min read

Configuration

3 min read

Secret Versioning

3 min read

Client-Side Encryption

4 min read

Troubleshooting

4 min read

Integrations

Use the GitHub Action or run the CLI in any CI pipeline or container.

Integrations Overview

3 min read

GitHub Actions

3 min read

CI/CD and Containers

4 min read

Use Cases

Real-world workflows: local development, CI/CD, multi-environment, and teams.

Local Development

3 min read

CI/CD Pipelines

3 min read

Multiple Environments

3 min read

Team Collaboration

3 min read

Migrating from .env Files

3 min read

Security & Compliance

Encryption, key management, audit logging, and security best practices.

Encryption Model

4 min read

Key Management

4 min read

Audit Logging

2 min read

Security Best Practices

4 min read

Administration

Members, roles and permissions, plan limits, and usage.

Member Management

3 min read

Roles & Permissions

3 min read

Plan Limits & Usage

3 min read

Troubleshooting

Fix common issues and look up CLI and API errors.

Common Issues

5 min read

Error Reference

3 min read