From 3c5df2670d0b5b3d25702d7296bd3eb2cb0067e5 Mon Sep 17 00:00:00 2001 From: stephenyeargin Date: Tue, 11 Aug 2026 13:16:07 -0500 Subject: [PATCH 1/2] Add copy/paste for Debian/Ubuntu, set flox service --- .flox/env/manifest.lock | 98 +++------------------------------------- .flox/env/manifest.toml | 2 +- install-flox/install.mdx | 97 +++++++++++++++++++++++++-------------- 3 files changed, 70 insertions(+), 127 deletions(-) diff --git a/.flox/env/manifest.lock b/.flox/env/manifest.lock index e76e066..3828eaf 100644 --- a/.flox/env/manifest.lock +++ b/.flox/env/manifest.lock @@ -19,7 +19,12 @@ "profile": { "common": " export NPM_CONFIG_PREFIX=\"$FLOX_ENV_CACHE/npm\"\n export PATH=\"$FLOX_ENV_CACHE/npm/bin:$PATH\"\n" }, - "options": {} + "options": {}, + "services": { + "docs": { + "command": "mint dev" + } + } }, "packages": [ { @@ -84,37 +89,6 @@ "group": "toplevel", "priority": 5 }, - { - "attr_path": "nodejs", - "broken": false, - "derivation": "/nix/store/aarkp2y0aj12skgji58mbf5va0dcf9bd-nodejs-24.14.1.drv", - "description": "Event-driven I/O framework for the V8 JavaScript engine", - "install_id": "nodejs", - "license": "MIT", - "locked_url": "https://github.com/flox/nixpkgs?rev=d233902339c02a9c334e7e593de68855ad26c4cb", - "name": "nodejs-24.14.1", - "pname": "nodejs", - "rev": "d233902339c02a9c334e7e593de68855ad26c4cb", - "rev_count": 998534, - "rev_date": "2026-05-15T18:21:44Z", - "scrape_date": "2026-05-17T08:01:42.769829Z", - "stabilities": [ - "staging", - "unstable" - ], - "unfree": false, - "version": "24.14.1", - "outputs_to_install": [ - "out", - "out" - ], - "outputs": { - "out": "/nix/store/w9axwcpzxv1cd78d6v748az2j08k6vfw-nodejs-24.14.1" - }, - "system": "x86_64-darwin", - "group": "toplevel", - "priority": 5 - }, { "attr_path": "nodejs", "broken": false, @@ -206,36 +180,6 @@ "group": "toplevel", "priority": 5 }, - { - "attr_path": "pandoc", - "broken": false, - "derivation": "/nix/store/x15gfpkflzx3gsg08y6rkx917darzb10-pandoc-cli-3.7.0.2.drv", - "description": "Conversion between documentation formats", - "install_id": "pandoc", - "license": "GPL-2.0-or-later", - "locked_url": "https://github.com/flox/nixpkgs?rev=d233902339c02a9c334e7e593de68855ad26c4cb", - "name": "pandoc-cli-3.7.0.2", - "pname": "pandoc", - "rev": "d233902339c02a9c334e7e593de68855ad26c4cb", - "rev_count": 998534, - "rev_date": "2026-05-15T18:21:44Z", - "scrape_date": "2026-05-17T08:01:48.495636Z", - "stabilities": [ - "staging", - "unstable" - ], - "unfree": false, - "version": "3.7.0.2", - "outputs_to_install": [ - "out" - ], - "outputs": { - "out": "/nix/store/1v6hfw7ar8pd36pvqh9l9sjnm5n288mc-pandoc-cli-3.7.0.2" - }, - "system": "x86_64-darwin", - "group": "toplevel", - "priority": 5 - }, { "attr_path": "pandoc", "broken": false, @@ -326,36 +270,6 @@ "group": "toplevel", "priority": 5 }, - { - "attr_path": "vale", - "broken": false, - "derivation": "/nix/store/rvxw7hffkng2a0549j0dzn9fs2ddv3bx-vale-3.14.1.drv", - "description": "Syntax-aware linter for prose built with speed and extensibility in mind", - "install_id": "vale", - "license": "MIT", - "locked_url": "https://github.com/flox/nixpkgs?rev=d233902339c02a9c334e7e593de68855ad26c4cb", - "name": "vale-3.14.1", - "pname": "vale", - "rev": "d233902339c02a9c334e7e593de68855ad26c4cb", - "rev_count": 998534, - "rev_date": "2026-05-15T18:21:44Z", - "scrape_date": "2026-05-17T08:03:58.551361Z", - "stabilities": [ - "staging", - "unstable" - ], - "unfree": false, - "version": "3.14.1", - "outputs_to_install": [ - "out" - ], - "outputs": { - "out": "/nix/store/56jykiasb7wbbhqflx5mhpp7rdi2hqrf-vale-3.14.1" - }, - "system": "x86_64-darwin", - "group": "toplevel", - "priority": 5 - }, { "attr_path": "vale", "broken": false, diff --git a/.flox/env/manifest.toml b/.flox/env/manifest.toml index f16764e..343c636 100644 --- a/.flox/env/manifest.toml +++ b/.flox/env/manifest.toml @@ -64,7 +64,7 @@ common = ''' ## $ flox activate --start-services <- Activates & starts all ## ------------------------------------------------------------------ [services] -# myservice.command = "python3 -m http.server" +docs.command = "mint dev" ## Include ---------------------------------------------------------- diff --git a/install-flox/install.mdx b/install-flox/install.mdx index 361b60d..84278eb 100644 --- a/install-flox/install.mdx +++ b/install-flox/install.mdx @@ -110,16 +110,21 @@ description: "How to install or upgrade the Flox CLI" **Download and install the package** - 1. Download flox.deb for your system architecture: + Run the command for your system architecture: - [64-bit Intel/AMD](https://downloads.flox.dev/by-env/stable/deb/flox-1.14.1.x86_64-linux.deb) - [64-bit ARM](https://downloads.flox.dev/by-env/stable/deb/flox-1.14.1.aarch64-linux.deb) + 64-bit Intel/AMD: - 1. Install the downloaded file + ``` + curl -LO https://downloads.flox.dev/by-env/stable/deb/flox-1.14.1.x86_64-linux.deb + sudo apt install ./flox-1.14.1.x86_64-linux.deb + ``` - ``` - sudo apt install /path/to/flox.deb - ``` + 64-bit ARM: + + ``` + curl -LO https://downloads.flox.dev/by-env/stable/deb/flox-1.14.1.aarch64-linux.deb + sudo apt install ./flox-1.14.1.aarch64-linux.deb + ``` @@ -181,16 +186,26 @@ description: "How to install or upgrade the Flox CLI" **Download and install the package** - 1. Download flox.rpm for your system architecture: + 1. Import the Flox archive keyring: - [64-bit Intel/AMD](https://downloads.flox.dev/by-env/stable/rpm/flox-1.14.1.x86_64-linux.rpm) - [64-bit ARM](https://downloads.flox.dev/by-env/stable/rpm/flox-1.14.1.aarch64-linux.rpm) + ``` + sudo rpm --import https://downloads.flox.dev/by-env/stable/rpm/flox-archive-keyring.asc + ``` - 1. Install the downloaded file + 1. Run the command for your system architecture: + + 64-bit Intel/AMD: ``` - sudo rpm --import https://downloads.flox.dev/by-env/stable/rpm/flox-archive-keyring.asc - sudo rpm -ivh /path/to/flox.rpm + curl -LO https://downloads.flox.dev/by-env/stable/rpm/flox-1.14.1.x86_64-linux.rpm + sudo rpm -ivh ./flox-1.14.1.x86_64-linux.rpm + ``` + + 64-bit ARM: + + ``` + curl -LO https://downloads.flox.dev/by-env/stable/rpm/flox-1.14.1.aarch64-linux.rpm + sudo rpm -ivh ./flox-1.14.1.aarch64-linux.rpm ``` @@ -580,16 +595,21 @@ description: "How to install or upgrade the Flox CLI" **Download and install the package** - 1. Download flox.deb for your system architecture: + Run the command for your system architecture: + + 64-bit Intel/AMD: - [64-bit Intel/AMD](https://downloads.flox.dev/by-env/stable/deb/flox-1.14.1.x86_64-linux.deb) - [64-bit ARM](https://downloads.flox.dev/by-env/stable/deb/flox-1.14.1.aarch64-linux.deb) + ``` + curl -LO https://downloads.flox.dev/by-env/stable/deb/flox-1.14.1.x86_64-linux.deb + sudo dpkg -i ./flox-1.14.1.x86_64-linux.deb + ``` - 1. Install the downloaded file + 64-bit ARM: - ``` - sudo dpkg -i /path/to/flox.deb - ``` + ``` + curl -LO https://downloads.flox.dev/by-env/stable/deb/flox-1.14.1.aarch64-linux.deb + sudo dpkg -i ./flox-1.14.1.aarch64-linux.deb + ``` @@ -601,16 +621,21 @@ description: "How to install or upgrade the Flox CLI" **Download and install the package** - 1. Download flox.deb for your system architecture: + Run the command for your system architecture: - [64-bit Intel/AMD](https://downloads.flox.dev/by-env/stable/deb/flox-1.14.1.x86_64-linux.deb) - [64-bit ARM](https://downloads.flox.dev/by-env/stable/deb/flox-1.14.1.aarch64-linux.deb) + 64-bit Intel/AMD: - 1. Install the downloaded file + ``` + curl -LO https://downloads.flox.dev/by-env/stable/deb/flox-1.14.1.x86_64-linux.deb + sudo dpkg -i ./flox-1.14.1.x86_64-linux.deb + ``` - ``` - sudo dpkg -i /path/to/flox.deb - ``` + 64-bit ARM: + + ``` + curl -LO https://downloads.flox.dev/by-env/stable/deb/flox-1.14.1.aarch64-linux.deb + sudo dpkg -i ./flox-1.14.1.aarch64-linux.deb + ``` @@ -622,17 +647,21 @@ description: "How to install or upgrade the Flox CLI" **Download and install the package** - 1. Download flox.rpm for your system architecture: + Run the command for your system architecture: - [64-bit Intel/AMD](https://downloads.flox.dev/by-env/stable/rpm/flox-1.14.1.x86_64-linux.rpm) - [64-bit ARM](https://downloads.flox.dev/by-env/stable/rpm/flox-1.14.1.aarch64-linux.rpm) + 64-bit Intel/AMD: - 1. Install the downloaded file + ``` + curl -LO https://downloads.flox.dev/by-env/stable/rpm/flox-1.14.1.x86_64-linux.rpm + sudo rpm -ivh ./flox-1.14.1.x86_64-linux.rpm + ``` + 64-bit ARM: - ``` - sudo rpm -ivh /path/to/flox.rpm - ``` + ``` + curl -LO https://downloads.flox.dev/by-env/stable/rpm/flox-1.14.1.aarch64-linux.rpm + sudo rpm -ivh ./flox-1.14.1.aarch64-linux.rpm + ``` **Ignore warning about systemd** From e5a0ff966fcd8b3962eb105179b8751f51253d8c Mon Sep 17 00:00:00 2001 From: stephenyeargin Date: Wed, 12 Aug 2026 10:52:24 -0500 Subject: [PATCH 2/2] docs(install): add experimental script installer tab Adds a new 'Script' tab at the top of the install page documenting the curl-pipe-to-shell installer at https://get.flox.dev. Marked experimental. Covers supported platforms, the Nix caveat, and the FLOX_CHANNEL / FLOX_VERSION override variables. --- install-flox/install.mdx | 63 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 63 insertions(+) diff --git a/install-flox/install.mdx b/install-flox/install.mdx index 84278eb..deda4dc 100644 --- a/install-flox/install.mdx +++ b/install-flox/install.mdx @@ -12,6 +12,69 @@ description: "How to install or upgrade the Flox CLI" Flox 1.14.1 online. + + + + **This install method is experimental.** + + The script installer is new and has not yet seen broad production use. + If you run into trouble, use one of the platform-specific tabs instead. + + + The quickest way to install Flox on macOS or Linux: + + ```bash + curl -fsSL https://get.flox.dev | sh + ``` + + The script detects your operating system and CPU architecture, then + installs Flox using the best package manager available: + + | Platform | Method | + |----------|--------| + | macOS | `.pkg` installer | + | Debian / Ubuntu | `apt` | + | Fedora / RHEL / Amazon Linux | `rpm` | + + + **Existing Nix installation?** + + The script will not modify an existing Nix installation. + Use the [Nix](#nix) tab instead. + + + ## Verify Flox installation + + If the following command returns without error then you're ready to get + started! + + ```console + $ flox --version + 1.14.1 + + ``` + + The version you see might be different. + + ## Advanced options + + Override the release channel or pin to a specific version with environment + variables before the command: + + ```bash + FLOX_CHANNEL=stable curl -fsSL https://get.flox.dev | sh + ``` + + ```bash + FLOX_VERSION=1.13.0 curl -fsSL https://get.flox.dev | sh + ``` + + ## Upgrade existing Flox installation + + The script will not upgrade an existing Flox installation. + Use the platform-specific tab for your OS to upgrade. + + Install Flox with the standalone [`.pkg` installer](#pkg-installer) or