a secure dotenv–from the creator of `dotenv`
Last release 16 days ago
10 Aug 2026
Ships on a steady schedule
a new release about every 8 days
Nearly every release is documented
notes for 328 of 338 stable releases
Nothing withdrawn
no release was ever pulled
3 years old
338 releases · first in 2023
Release timeline
338 releases since 2023Releases
- 1.47.39 Jul 2025
- 1.47.29 Jul 2025
- 1.47.19 Jul 2025
Release notes2 sources agree
Open source →Added
- Add convenience log that
radar active 📡when dotenvx-radar is installed (#625)
- Add convenience log that
- 1.47.08 Jul 2025
Release notes2 sources agree
Open source →Added
- Add optional
dotenvx radarcommand (#624) - Radar is an early access commercial extension for dotenvx that will auto backup your .env files.
_______________________________________________________________________ | | | Dotenvx Radar: Env Observability | | | | ░▒▓███████▓▒░ ░▒▓██████▓▒░░▒▓███████▓▒░ ░▒▓██████▓▒░░▒▓███████▓▒░ | | ░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░ | | ░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░ | | ░▒▓███████▓▒░░▒▓████████▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓████████▓▒░▒▓███████▓▒░ | | ░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░ | | ░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░ | | ░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓███████▓▒░░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░ | | | | Observe, version, and back up your environment variables at runtime. | | | | Purchase lifetime access at https://dotenvx.com/radar | | | | --------------------------------------------------------------------- | | - thank you for using dotenvx! - @motdotla | |_______________________________________________________________________| - Add optional
- 1.46.07 Jul 2025
Release notes2 sources agree
Open source →Added
- Add error when hoisting issue experienced around commander.js (#623)
Removed
- Remove
git-dotenvxandgit dotenvxshorthand (#621)
- 1.45.22 Jul 2025
- 1.45.120 Jun 2025
Release notes2 sources agree
Open source →Changed
- Include
setLogNameandsetLogVersioninconfig(#613)
- Include
- 1.45.020 Jun 2025
Release notes2 sources agree
Open source →Added
- Add
logger.setNameandlogger.setVersionfor customization of logger (#612)
- Add
- 1.44.211 Jun 2025
- 1.44.119 May 2025
- 1.44.012 May 2025
- 1.43.04 May 2025
Release notes2 sources agree
Open source →Removed
- Remove
errorv, errornocolor, blankfrom logger options (#584)
Changed
- Replace instances of
console.errorwithlogger.error(#584)
- Remove
- 1.42.22 May 2025
- 1.42.12 May 2025
- 1.42.030 Apr 2025
Release notes2 sources agree
Open source →Added
- Add ability to override the
osandarchviainstall.shanddotenvx.sh(3ded752)
- Add ability to override the
- 1.41.018 Apr 2025
Release notes2 sources agree
Open source →Added
- Add [directory] argument to precommit and prebuild (#572)
- 1.40.117 Apr 2025
- 1.40.013 Apr 2025
Release notes2 sources agree
Open source →Added
- Smarter
ext precommitandext prebuild– catch duplicate KEYs in the same .env file where one is mistakenly left unencrypted (#567)
- Smarter
- 1.39.14 Apr 2025
- 1.39.016 Mar 2025
Release notes2 sources agree
Open source → - 1.38.512 Mar 2025
Release notes2 sources agree
Open source →Added
- 🐞 Add
config.d.tsfile to fix type error when loadingdotenvx/dotenvx/configwith dynamic import (#547)
- 🐞 Add
- 1.38.44 Mar 2025
Release notes2 sources agree
Open source →Changed
- 🐞 Fix blank line disappearing after encrypting empty value (#542)
- 1.38.325 Feb 2025
Release notes2 sources agree
Open source →Changed
- 🐞 Fix self-referencing expansion when key exists already in
process.env(#536)
- 🐞 Fix self-referencing expansion when key exists already in
- 1.38.224 Feb 2025
- 1.38.124 Feb 2025
Release notes2 sources agree
Open source →Changed
- Support
encryptwhen mutliline contains windowsCRLF(\r\n) (#534)
Note: dotenvx will convert these
\r\nnewlines to\n. Our recommendation is to stop usingCRLF- its origin is from typewriter days. Instead, set your editor or gitattributes to useLF. - Support
- 1.38.024 Feb 2025
- 1.37.021 Feb 2025
Release notes2 sources agree
Open source → - 1.36.012 Feb 2025
Release notes2 sources agree
Open source →Changed
--strictflag respects (doesn't throw) anything in--ignoreflag (#527)
- 1.35.07 Feb 2025
Release notes2 sources agree
Open source →Added
The addition of
main.getfacilitates what we term Decryption at Access, a concept explored in greater detail in our whitepaper. - 1.34.025 Jan 2025
- 1.33.013 Jan 2025
Release notes2 sources agree
Open source →Added
- support ESM import convenience
import '@dotenvx/dotenvx/config'(#508)
- support ESM import convenience
- 1.32.18 Jan 2025
- 1.32.027 Dec 2024
Release notes2 sources agree
Open source →Added
- add encrypted check support for
ext prebuild(#501)
Changed
- modify
ext precommitto check git modified state as well as git staged state - useful for usingdotenvx ext precommitwithout the--installflag in automated scripts and ci. (#499)
Removed
- remove internal logger methods
errorvp, errorvpb, warnv, warnvp, warnvpb, successvp, successvpb, help2(#501)
- add encrypted check support for
- 1.31.320 Dec 2024
Release notes2 sources agree
Open source →Changed
- adjust wingetcreate to use powershell when parsing version
- 1.31.220 Dec 2024
- 1.31.120 Dec 2024
Release notes2 sources agree
Open source →Changed
- 🐞 fix encryption of values containing explicit
\nnewlines (#495)
- 🐞 fix encryption of values containing explicit
- 1.31.014 Dec 2024
Release notes2 sources agree
Open source → - 1.30.114 Dec 2024
Release notes2 sources agree
Open source →Added
- support complex command substitution combining variable expansion (#490)
- 1.30.014 Dec 2024
Release notes2 sources agree
Open source →Added
- add
-fk(--env-keys-file) flag to customize the path to your.env.keysfile withrun, get, set, encrypt, decrypt, and keypair🎉 (#486)
This is great for monorepos. Maintain one
.env.keysfile across all your apps.$ dotenvx encrypt -fk .env.keys -f apps/backend/.env $ dotenvx encrypt -fk .env.keys -f apps/frontend/.env $ tree -a . ├── .env.keys └── apps ├── backend │ └── .env └── frontend └── .env $ dotenvx get -fk .env.keys -f apps/backend/.env - add
- 1.29.09 Dec 2024
Release notes2 sources agree
Open source →Added
- add
--ignoreflag to suppress specified errors. example:dotenvx run --ignore=MISSING_ENV_FILE(#485)
- add
- 1.28.03 Dec 2024
Release notes2 sources agree
Open source →Changed
.env.keysfile is generated WITHOUT quotes going forward. This is to minimize friction around Docker gotchas to developers - old versions of Docker do not support--env-filecontaining quoted keys/values. (#480) (additional note)
- 1.27.03 Dec 2024
Release notes2 sources agree
Open source →Added
- add support for
\texpansion when double quoted. (e.g.TAB="hi\tfriend"becomeshi friend) (#479)
- add support for
- 1.26.22 Dec 2024
- 1.26.12 Dec 2024
Release notes2 sources agree
Open source →Added
- add typescript type definitions for
main.parsemethod (#475)
- add typescript type definitions for
- 1.26.030 Nov 2024
- 1.25.229 Nov 2024
Release notes2 sources agree
Open source →Added
- for binaries add pre-build step using esbuild (#471)
Removed
- remove types for functions that were removed a while back (2aa660)
- 1.25.126 Nov 2024
Release notes2 sources agree
Open source →Changed
- improve helpful error messaging around decryption failures by specifying specific key and private key name (#463)
- 1.25.025 Nov 2024
Release notes2 sources agree
Open source →Added
- add
run --strictflag to exit with code1if any errors are encountered - like a missing.envfile or decryption failure (#460) - add
get --strictflag to exit with code1if any errors are encountered - like a missing.envfile or decryption failure (#461) - add
strictoption toconfig()to throw for any errors (#459)
Changed
- log
MISSING_ENV_FILEandDECRYPTION_FAILEDerrors to stderr (prior was stdout as a warning) (#459)
Removed
- remove
dotenvx.get()function fromlib/main.js. (parsealready historically exists for this purpose) (#461)
- add
- 1.24.522 Nov 2024
- 1.24.420 Nov 2024
- 1.24.320 Nov 2024
Release notes2 sources agree
Open source →Changed
- 🐞 fix command substitution for more complex commands (#455)
- 1.24.218 Nov 2024
Release notes2 sources agree
Open source →Changed
- treat pre-existing expandable values as literal in
process.env(#450)
- treat pre-existing expandable values as literal in
- 1.24.118 Nov 2024
Release notes2 sources agree
Open source →Changed
- bump
cross-spawnto prevent potential ReDoS CVE-2024-21538 (#449)
- bump
- 1.24.015 Nov 2024
Release notes2 sources agree
Open source →Added
- support progressive append/update (#445)
FOO=foo FOO=${FOO}bar # foobar- support alternate value expansion (#445)
<img width="1608" alt="image" src="https://github.com/user-attachments/assets/fdd55a0a-9b36-4cb3-b0c6-6b019441aef4">
Changed
dotenvx.parsenow maps to dotenvx's internal parser. (prior it was mapping to dotenv's)
Removed
- removed
dotenvx.configDotenv(). usedotenvx.config()(#445)
- 1.23.013 Nov 2024
Release notes2 sources agree
Open source →Added
- deeper variable expansion support and protection against self-referencing variables 🛡️ (#439)
- 1.22.212 Nov 2024
Release notes2 sources agree
Open source →Changed
- more lenient handling of
--separator and better error messaging when flags are ambiguous (#438)
- more lenient handling of
- 1.22.112 Nov 2024
Release notes2 sources agree
Open source →Changed
- 🐞 patch loading order issue with single quotes (#436)
- 1.22.04 Nov 2024
Release notes2 sources agree
Open source →Added
- add
--patternargument toext gitignore(dotenvx ext gitignore --pattern .env.keys) (#430)
Changed
- clarify next steps after first time encrypting (#430)
- add
- 1.21.131 Oct 2024
- 1.21.025 Oct 2024
Release notes2 sources agree
Open source →Changed
🎓 now if you choose to single quote, double quote, no quote, or backtick your value it will be respected - including for encrypted values. this more intuitively handles complex cases like escaped characters, literals, and json.