Skip to content

Update configuration.html.markerb #2192

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
kcmartin merged 2 commits into from
Jul 17, 2026
Merged

Update configuration.html.markerb #2192

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
493d9fe
Update configuration.html.markerb
mstahv Aug 21, 2025
9433c6d
Update deprecated builder and buildpack path in second example
kcmartin Jul 17, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 9 additions & 3 deletions reference/configuration.html.markerb
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@
- Run [`flyctl config save -a <existing-app-name>`](/docs/flyctl/config-save/) to download a `fly.toml` file from an existing app.
- Create one by hand with help from this reference, or copy and modify an example file.

### Config file formats

Check failure on line 19 in reference/configuration.html.markerb

View workflow job for this annotation

GitHub Actions / Vale linter 

[vale] reported by reviewdog 🐶
[Vale.Terms] Use 'configs?\b' instead of 'Config'.

Raw Output:
{"message": "[Vale.Terms] Use 'configs?\\b' instead of 'Config'.", "location": {"path": "reference/configuration.html.markerb", "range": {"start": {"line": 19, "column": 5}}}, "severity": "ERROR"}

The default configuration file generated by Fly Launch is called `fly.toml`.

Expand Down Expand Up @@ -98,13 +98,19 @@

```toml
[build]
builder = "paketobuildpacks/builder:base"
buildpacks = ["gcr.io/paketo-buildpacks/nodejs"]
builder = "paketobuildpacks/builder-jammy-base"
```

The builder "builder" uses CNB Buildpacks and Builders to create the application image. These are third party toolkits which can use Heroku compatible build processes or other tools. The tooling is all managed by the buildpacks and buildpacks are assembled into CNB Builders - images complete with the buildpacks and OS to run the tool chains.

In our example above, the builder is being set to use [Paketo's all-purpose builder](https://paketo.io) with the NodeJS buildpack.
In our example above, the builder is being set to use [Paketo's all-purpose builder](https://paketo.io) which automatically detects needed buildpacks.

You can also explicitly define buildpacks:
```toml
[build]
builder = "paketobuildpacks/builder-jammy-base"
buildpacks = ["docker.io/paketobuildpacks/nodejs"]
```

### Specify a Docker image

Expand Down Expand Up @@ -927,7 +933,7 @@
Again, times are in milliseconds unless units are specified.

## The `processes` section

Check failure on line 936 in reference/configuration.html.markerb

View workflow job for this annotation

GitHub Actions / Vale linter 

[vale] reported by reviewdog 🐶
[Vale.Terms] Use 'VM('s)?\b' instead of 'vm'.

Raw Output:
{"message": "[Vale.Terms] Use 'VM('s)?\\b' instead of 'vm'.", "location": {"path": "reference/configuration.html.markerb", "range": {"start": {"line": 936, "column": 304}}}, "severity": "ERROR"}

Check failure on line 936 in reference/configuration.html.markerb

View workflow job for this annotation

GitHub Actions / Vale linter 

[vale] reported by reviewdog 🐶
[Vale.Terms] Use 'VM('s)?\b' instead of 'vm'.

Raw Output:
{"message": "[Vale.Terms] Use 'VM('s)?\\b' instead of 'vm'.", "location": {"path": "reference/configuration.html.markerb", "range": {"start": {"line": 936, "column": 100}}}, "severity": "ERROR"}

Check failure on line 936 in reference/configuration.html.markerb

View workflow job for this annotation

GitHub Actions / Vale linter 

[vale] reported by reviewdog 🐶
[Vale.Terms] Use 'VM('s)?\b' instead of 'vm'.

Raw Output:
{"message": "[Vale.Terms] Use 'VM('s)?\\b' instead of 'vm'.", "location": {"path": "reference/configuration.html.markerb", "range": {"start": {"line": 936, "column": 50}}}, "severity": "ERROR"}
The `processes` section allows you to define process groups to be run on separate Machines within a single app. Learn more about [running multiple process groups in an app](/docs/apps/processes/).

**Each Machine can run a different command on start**, allowing you to re-use your code base for different tasks (web server, queue worker, etc).
Expand Down
Loading