# Nixpacks Configuration File (nixpacks.toml)

**Canonical:** https://apis.io/apis/nixpacks/configuration-file/  
**Provider:** Nixpacks — https://apis.io/providers/nixpacks/  
**Documentation:** https://nixpacks.com/docs/configuration/file

Nixpacks Configuration File (nixpacks.toml) is one of 5 APIs that [Nixpacks](https://apis.io/providers/nixpacks/) publishes on the [APIs.io](https://apis.io/) network. Tagged areas include Configuration, TOML, Phases, and Customization. The published artifact set on APIs.io includes API documentation and an API reference.

Projects can override or extend the auto-detected build plan by committing a `nixpacks.toml` (or `nixpacks.json`) file at the root of the repository. The configuration file mirrors the build-plan structure with top-level `providers`, `buildImage`, `variables`, and `staticAssets`, a `[phases.<name>]` table for each phase carrying `cmds`, `nixPkgs`, `nixLibs`, `aptPkgs`, `dependsOn`, `cacheDirectories`, `onlyIncludeFiles`, and `paths`, and a `[start]` table for `cmd`, `runImage`, and runtime-only file inclusion. The `"..."` token can be used inside array fields to extend rather than replace provider-supplied values.

## Machine-readable artifacts (2)

- **Documentation** — https://nixpacks.com/docs/configuration/file
- **Reference** — https://nixpacks.com/docs/configuration/environment

## Other Nixpacks APIs (4)

- [Nixpacks CLI](https://apis.io/apis/nixpacks/cli/)
- [Nixpacks Build Plan](https://apis.io/apis/nixpacks/build-plan/)
- [Nixpacks Language Providers](https://apis.io/apis/nixpacks/providers/)
- [Nixpacks GitHub Action](https://apis.io/apis/nixpacks/github-action/)

## Tags

Configuration, TOML, Phases, Customization

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/nixpacks/configuration-file/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/nixpacks/.