CHANGELOG

April 24, 2026 ยท View on GitHub

v4.0.1 (2026-04-24)

Fixes

  • Fix MultipleKeysError on conda 25.11+ when a user-supplied condarc-file already declares auto_activate: now only one of auto_activate / auto_activate_base is written to .condarc, preferring whichever key the user's existing condarc uses.
  • Add auto_activate to the boolean coercion set so its value is serialized as a YAML boolean when it is the chosen canonical key.
  • Add local_repodata_ttl to KNOWN_CONDARC_KEYS to silence a spurious "Unrecognized condarc key" warning for a valid conda key.

v4.0.0 (2026-04-23)

Breaking Changes

  • #459: Upgrade action runtime to Node.js 24.x (requires runners with Node 24 support; this is the reason for the v4 major bump)
  • #450: Switch action build to ESM (for @actions/exec v3)

Features and Enhancements

  • #469: Add conda-init input to optionally skip conda init and document activation for restricted environments
  • #482: Add channels parsing utility and URL validation
  • #481: Enable stricter TypeScript checks and typing
  • #480: Add more tests, increase coverage, add Codecov integration and coverage badge
  • #479: Add TypeDoc-based API docs, generation and checks; configure GitHub Pages and Netlify previews

Fixes

  • #465: Fix double channel configuration being applied
  • #467: Speed up Windows post-run cleanup by moving the extracted packages directory instead of removing files one by one
  • #470: Fix name-version-build syntax expansion and add tests
  • #475: Split shell init and activation of the test environment to remove spurious warning

Performance

  • #486: Remove HTML index scraping for Miniconda version validation
  • #487: Parallelize Windows takeown calls with Promise.all
  • #488: Replace isDefaultEnvironment subprocess with local YAML reads
  • #489: Replace conda config subprocesses with direct .condarc YAML writes

Tasks and Maintenance

  • #444: Bump conda-incubator/setup-miniconda from 3.2.0 to 3.3.0
  • #445: Bump actions/checkout from 6.0.1 to 6.0.2
  • #449: Bump @actions/exec from 2.0.0 to 3.0.0
  • #456, #484, #491: Bump actions/upload-artifact
  • #460: Bump actions/download-artifact from 7.0.0 to 8.0.1
  • #464: Update dependencies for actions and packages
  • #466: Bump @actions/tool-cache from 2.0.2 to 4.0.0
  • #473: Bump flatted from 3.2.9 to 3.4.2
  • #476: Bump picomatch
  • #477: Bump conda-incubator/installer from 0.1.0 to 0.1.1
  • #485: Bump vite from 8.0.0 to 8.0.8
  • #492: Bump actions/upload-pages-artifact from 3 to 5
  • #493: Bump marocchino/sticky-pull-request-comment from 2 to 3
  • #494: Bump actions/deploy-pages from 4 to 5
  • #495: Bump codecov/codecov-action from 5 to 6
  • #496: Bump @actions/core from 3.0.0 to 3.0.1

v3.3.0 (2026-01-20)

Fixes

  • #410: Ignore auto_activate warning
  • #411: Deprecate auto-activate-base input
  • #414: Activate default environment instead of base environment
  • #435: fix: remove accidental indentation from shell config template strings
  • #442: Translate POSIX set to xonsh's equivalent

Tasks and Maintenance

  • #405, #413, #439: Bump normalize-url from 8.0.1 to 8.1.1
  • #425: Bump @actions/io from 1.1.3 to 2.0.0
  • #432: Bump @actions/exec from 1.1.1 to 2.0.0
  • #433, #441: Bump @actions/core from 1.11.1 to 2.0.2
  • #416: Bump semver and @types/semver
  • #421: Bump actions/setup-node from 5 to 6
  • #427: Bump js-yaml from 4.1.0 to 4.1.1

v3.2.0 (2025-06-04)

Fixes

  • #398 Check all .condarc files when removing defaults
  • #397 Add version normalization for minicondaVersion in input validation
  • #402 Workaround for auto_activate_base deprecation

Tasks and Maintenance

  • #391 Bump conda-incubator/setup-miniconda from 3.1.0 to 3.1.1
  • #390 Bump undici from 5.28.4 to 5.28.5
  • #399 Bump semver and @types/semver

v3.1.1 (2025-01-20)

Fixes

  • #378: Make nodefaults warning more explicit
  • #387: Detect and support Linux ARM runners for both Miniconda and Miniforge

Tasks and Maintenance

  • #374: Bump conda-incubator/setup-miniconda from 3.0.4 to 3.1.0
  • #375: Bump actions/cache from 3 to 4
  • #384: Bump @actions/tool-cache from 2.0.1 to 2.0.2
  • #386: Fix link to example 14
  • #388: Fix mamba 1.x examples

v3.1.0 (2024-10-31)

Features

  • #367: Add conda-remove-defaults setting to remove the defaults channel if added implicitly
  • #342: Add installation-dir to customize where the installers are installed to
  • #328: Make conda's cache configurable via pkgs-dirs

Fixes

  • #360: Start deprecation of miniforge-variant: Mambaforge
  • #362: Ignore conda cygpath warning
  • #368: Address mamba v2 incompatibilities
  • #350: set CONDA environment variable regardless of useBundled option

Tasks and Maintenance

  • #348: Bump conda-incubator/setup-miniconda from 3.0.3 to 3.0.4
  • #353: Bump semver and @types/semver
  • #356: Bump braces from 3.0.2 to 3.0.3
  • #359: Bump semver from 7.6.2 to 7.6.3
  • #370: Bump @actions/core from 1.10.1 to 1.11.1

v3.0.4 (2024-04-25)

Fixes

  • #345 Fix running on macOS 13 on Intel since the runners no longer provide miniconda by default.

Tasks and Maintenance

  • #337 Bump conda-incubator/setup-miniconda from 3.0.2 to 3.0.3 (#337)
  • #338 Bump normalize-url from 8.0.0 to 8.0.1
  • #340 Bump undici from 5.27.4 to 5.28.5

v3.0.3 (2024-02-27)

Fixes

  • #336 Fall back to miniconda3 latest when no bundled version + empty with params

Tasks and Maintenance

  • #335 Bump conda-incubator/setup-miniconda from 3.0.1 to 3.0.2

v3.0.2 (2024-02-22)

Fixes

  • #312 Enable ARM64 on macOS for Miniforge and Mambaforge including automatic architecture detection.

Tasks and Maintenance

  • #327 Bump conda-incubator/setup-miniconda from 3.0.0 to 3.0.1
  • #330 Bump actions/cache from 3 to 4
  • #334 Bump undici from 5.27.2 to 5.28.3

v3.0.1 (2023-11-29)

Fixes

  • #325 Fix environment activation on windows (a v3 regression) due to hard-coded install PATH

v3.0.0 (2023-11-27)

Features

  • #308 Update to node20
  • #291 Add conda-solver option (defaults to libmamba)

Fixes

  • #299 Fix condaBasePath when useBundled is false, and there's no pre-existing conda

Documentation

  • #309 Switch to main branch based development
  • #313 Specify team conda-incubator/setup-miniconda as codeowners
  • #318 README: update actions in examples, add security section, similar actions

Tasks and Maintenance

  • #307 Run dependabot against main branch and also update node packages
  • #311 Bump actions/checkout from 2 to 4
  • #310 Bump actions/cache from 1 to 3
  • #314 Strip/update dependencies
  • #315 Split lint into check and build, switch from npm install to npm ci
  • #317 Bump normalize-url from 4.5.1 to 8.0.0
  • #316 Faster workflow response / saving resources via timeout/concurrency policy

v2.3.0 (2023-11-22)

Documentation

  • #263 Update links to GitHub shell docs
  • #289 Consider leading with conda activation does not work on sh, please use bash

Features

  • #296 Update Miniconda architectures (enables M1 = osx-arm64 runners)

Tasks and Maintenance

  • #273 Bump json5 from 1.0.1 to 1.0.2
  • #293 Remove Python 2.7 from test matrix (EOL since April 2020, >4 years)
  • #294 Update dependencies
  • #295 Add dependabot config to update action versions in workflows by
  • #300 Fix CI (lint + examples)
  • #304 Fix CI: Remove not working example-13, use Miniforge in example-6

v2.2.0 (2021-11-11)

Documentation

  • #187 Document missing bundled conda for self hosted runners
  • #200 Provided instructions on how to cache deployed environments for Miniforge variants.
  • #246 Fix broken link in README.
  • #251 Fix typo in README.
  • #256 Update bash commands to include error flag.

Features

  • #234 Add input option (run-post: false) to skip post processing.

Fixes

  • #189 Error on miniconda-version not specified instead of when it is specified.
  • #190 Add regression checks for pinning python version in the created environment.
  • #209 Do not move non-existing files.
  • #212 Fix caching example. No need to hardcode paths. Write date to step output.
  • #230 Fix path handling inconsistency in installer caching.

Tasks and Maintenance

  • #210 Use 'npm run ...' to run scripts.
  • #233 Add deprecation warning on master branch.
  • #252 use Node.js 16 instead of deprecated Node.js 12
  • #257 Update dependencies.

v2.1.1 (2021-03-31)

Features

  • #163 leaves the patched setup-miniconda-patched-{environment.yml} in-place if clean-patched-environment-file: false is given (otherwise cleans up after itself)
  • #163 adds action outputs environment-file, environment-file-content and environment-file-was-patched

Fixes

  • #161 restores proper ordering of channels when environment-file is patched
  • #163 if necessary, writes setup-miniconda-patched-environment.yml to the same location to work with relative paths, e.g. pip: ["-r requirements.txt"]

v2.1.0 (2021-03-29)

Features

  • #130 installs all extra tools (e.g. conda-build) in a single solve
  • #133, #138, and #140 add first-class support for Miniforge (and Mambaforge)
  • #137 allows activate-environment to be a path-like prefix

Documentation

  • #115 adds extra information on default environment activation.

Fixes

  • #120 allows channels to be null
  • #148 allows use of 32-bit installers on Linux

Development

v2.0.1 (2020-11-29)

Fixes

  • #97 fixes installer-url on Windows.
  • #94, #95 catches ignored errors when an environment file contains invalid section names #93.
  • #100 fixes mamba not being available on Windows if using a bash shell #59.

v2.0.0 (2020-11-08)

Fixes

  • #79 fixes GitHub deprecation warnings #78.

Features

  • #61, #74 adds support for explicit environment specifications.

v1.7.0 (2020-08-19)

Fixes

  • #64 fixes a bug on post section with removing conda files.

Features

  • #52 adds x32 support for some machines.
  • #53 allows environment files to omit the name field.

v1.6.0 (2020-07-11)

Features

  • #47 adds support for installing and using mamba instead of conda.

v1.5.0 (2020-05-28)

Fixes

  • #46 fixes conflicting channels on environment.yml files and the action input channels.

Features

  • #43 adds support for custom installers, e.g. miniforge

v1.4.1 (2020-05-22)

Fixes

  • fixes a small regression on windows systems.

v1.4.0 (2020-05-22)

Features

  • #41 adds a post step to remove any uncompressed packages found in the packages dir, so the cache can also save packages that were installed in different steps from the action step.

v1.3.1 (2020-05-17)

Fixes

  • #47 fixes regression in systems where the cache folder has not been created.

v1.3.0 (2020-05-14)

Features

  • #35 adds the possibility of using the cache action to cache downloaded conda packages and (hopefully) reduce build times.

v1.2.0 (2020-05-11)

Features

  • #33 adds additional configuration options to the action input, including:
- allow-softlinks
- channel-priority
- show-channel-urls
- use-only-tar-bz2

v1.1.4 (2020-05-06)

Fixes

  • fixes regression on shell environment variable checking.

v1.1.3 (2020-05-06)

Fixes

  • #28 fixes some small issues.

Features

  • #22 adds new URL for downloading packages.

v1.1.2 (2020-04-11)

Fixes

  • fixes regression with file permissions.

v1.1.1 (2020-04-11)

Fixes

  • fixes some channel issues.

v1.1.0 (2020-04-11)

Fixes

  • #11 fix pipefail issues.

Features

  • #17 add channels support.

v1.0.2 (2019-12-23)

Fixes

  • #6 fixes windows environment activation

v1.0.1 (2019-12-19)

Features

  • first official release!