Configuration

Foundry uses foundry.toml for project configuration. This file controls compiler settings, test behavior, formatting rules, and more.

A minimal configuration:

foundry.toml

[profile.default]
src = "src"
out = "out"
libs = ["lib"]
solc_version = "0.8.28"

View your resolved configuration:

$ forge config

Feature	Description
Profiles	Switch between configurations for development, CI, and production
Environment variables	Override settings without modifying files
Global config	Share settings across all your projects
Remappings	Customize import paths for dependencies

Configure different settings for development, CI, and production.

Set up GitHub Actions and other CI systems.

Configure VS Code and other editors for Foundry projects.

Tune solc settings, via IR, and dynamic test linking.

Control fuzzing, invariants, and test behavior.

Manage RPC endpoints across all your crypto tools from a single config file.

Complete reference for all configuration options.

Was this helpful?