flox/install-flox-action
Compare Source
This release adds a floxhub-token field that allows authenticating with a service account token or personal access token.
Full Changelog: flox/install-flox-action@v2.6.0...v2.7.0
Compare Source
What's Changed
Fixes repeated runs on self-hosted runners, and any other runner whose disk survives between jobs, where the action previously failed on every run after the first.
New Contributors
Full Changelog: flox/install-flox-action@v2...v2.6.0
Compare Source
What's changed
Fixes
disable-metrics: stop silently overriding workflow-level
FLOX_DISABLE_METRICS. The input defaulted to "false" and was always
exported to FLOX_DISABLE_METRICS, overwriting any value a calling workflow
set via its env: block — silently re-enabling metrics. It now defaults to
empty and is only exported when explicitly set, so a workflow-level
FLOX_DISABLE_METRICS: "true" is honored. (#209, ECO-104)
Dependencies
- Bump the all group across 1 directory with 4 updates
Full Changelog: flox/install-flox-action@v2.5.2...v2.5.3
Compare Source
What's Changed
- fix(cache): don't serve a stale package for unpinned versions by @devusb in #207
Full Changelog: flox/install-flox-action@v2...v2.5.2
Compare Source
What's changed
This patch bundles the runner fixes and dependency updates that landed on main alongside the v2.5.0 write-summary feature, so consumers on @v2 receive the complete set.
Fixes
- Detect systemd via
/proc/1/comm instead of nix.conf
chown /nix to the runner user in single-user mode
CI and dependencies
- Add an ubuntu-slim runner to the test matrix and verify
flox runs; run flox init in a tmpdir; keep test-act on ubuntu-latest
- Routine dependency updates (4 packages)
Full Changelog: flox/install-flox-action@v2.5.0...v2.5.1
Compare Source
What's changed
The Flox installation summary is now opt-in. The action previously wrote a "Flox Installation" table to the GitHub Actions job summary ($GITHUB_STEP_SUMMARY) after every install. That table is noise in workflows that use the job summary for their own output, such as Terraform or Terragrunt plan results, so it is now off by default.
A new write-summary input controls it:
- uses: flox/install-flox-action@v2
with:
write-summary: true # restore the installation summary
⚠️ Behavior change
If you relied on the installation summary appearing automatically, set write-summary: true to restore it. No inputs were removed and no outputs changed; nothing else in your workflow is affected.
This release also rolls up routine dependency updates merged since v2.4.1.
Full Changelog: flox/install-flox-action@v2.4.1...v2.5.0
Compare Source
Marketplace metadata refresh
Update the action's GitHub Marketplace metadata for publication:
- Capitalize the Flox brand in
name, description, and author (the lowercase flox is reserved for CLI invocation).
- Rewrite the description in imperative voice with brand-consistent capitalization and no trailing period, per Marketplace description conventions.
- Update the
author: email from the outdated floxdev.com domain to flox.dev.
Also includes README hygiene: brand capitalization throughout, code samples pinned to the major-version tag (@v2), and indented step items in the example workflow.
This is a metadata-only release. The action's runtime behavior, inputs, and outputs are unchanged. Existing workflows using flox/install-flox-action@vN continue to work without modification.
Compare Source
What's New
- Nix fallback: When Nix is pre-installed, installs Flox via
nix profile install instead of failing
- Package caching: New
use-cache input caches downloaded packages for faster subsequent runs
- Proxy support: New
proxy input for HTTP/HTTPS/SOCKS5 proxy configuration
- Post-install configuration: New inputs for
trusted-environments, extra-nix-config, extra-substituters, extra-substituter-keys, extra-flox-config, disable-upgrade-notifications
- GitHub token: New
github-token input for Nix flake rate limiting
- Action outputs:
flox-version, flox-path, nix-detected
- Job summary: GitHub Actions Job Summary with installation details
- Benchmarks: Added
scripts/benchmark.sh for installation performance comparison
- CI: Added
nektos/act job for local runner testing
New Inputs
| Input |
Description |
Default |
github-token |
GitHub token for Nix flake rate limiting |
${{ github.token }} |
trusted-environments |
Comma-separated FloxHub envs to trust |
"" |
extra-nix-config |
Lines to append to /etc/nix/nix.conf |
"" |
extra-substituters |
Nix binary cache URLs |
"" |
extra-substituter-keys |
Public keys for extra substituters |
"" |
proxy |
HTTP/HTTPS/SOCKS5 proxy URL |
"" |
disable-upgrade-notifications |
Suppress upgrade notifications |
"true" |
extra-flox-config |
Key=value pairs for flox config --set |
"" |
use-cache |
Cache downloaded package for faster runs |
"true" |
New Outputs
| Output |
Description |
flox-version |
Installed flox version string |
flox-path |
Absolute path to flox binary |
nix-detected |
Whether Nix was pre-installed |
Compare Source
What's Changed
- docs: add CLAUDE.md for Claude Code guidance by @garbas in #167
- chore(deps-dev): Bump the all group with 3 updates by @dependabot[bot] in #170
- chore(deps): Bump the all group with 2 updates by @dependabot[bot] in #169
- chore(deps-dev): Bump prettier from 3.8.0 to 3.8.1 in the all group by @dependabot[bot] in #171
- feat: support installing Flox when Nix is already present by @garbas in #172
Full Changelog: flox/install-flox-action@v2...v2.3.0
Compare Source
New Features
- Network Resilience: Added retry logic for both downloading and installing Flox packages. Configurable via the new
retries input (default: 3). This helps avoid transient network failures in CI environments. (#164, #165)
Documentation
- Added caching documentation explaining how Flox Catalog provides pre-built packages and how to use
flox build/flox publish for custom package caching. (#163)
Internal
- Migrated development environment from Nix flake to Flox environment (#162)
Compare Source
What's Changed
Full Changelog: flox/install-flox-action@v2...v2.1.0