Skip to content

docs(install): add experimental script installer tab #71

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

Closed
stephenyeargin wants to merge 2 commits into from
Closed

docs(install): add experimental script installer tab #71

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
3c5df26
Add copy/paste for Debian/Ubuntu, set flox service
stephenyeargin Aug 11, 2026
e5a0ff9
docs(install): add experimental script installer tab
stephenyeargin Aug 12, 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
98 changes: 6 additions & 92 deletions .flox/env/manifest.lock
View file
Open in desktop

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion .flox/env/manifest.toml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -64,7 +64,7 @@ common = '''
## $ flox activate --start-services <- Activates & starts all
## ------------------------------------------------------------------
[services]
# myservice.command = "python3 -m http.server"
docs.command = "mint dev"


## Include ----------------------------------------------------------
Expand Down
160 changes: 126 additions & 34 deletions install-flox/install.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,69 @@ description: "How to install or upgrade the Flox CLI"
Flox 1.14.1 online.
</Note>
<Tabs>
<Tab title="Script">

<Warning>
**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.
</Warning>

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` |

<Note>
**Existing Nix installation?**

The script will not modify an existing Nix installation.
Use the [Nix](#nix) tab instead.
</Note>

## 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.

</Tab>
<Tab title="MacOS">

Install Flox with the standalone [`.pkg` installer](#pkg-installer) or
Expand Down Expand Up @@ -110,16 +173,21 @@ description: "How to install or upgrade the Flox CLI"
</Note>
**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
```

<Accordion title="This will replace an existing Nix installation">

Expand Down Expand Up @@ -181,16 +249,26 @@ description: "How to install or upgrade the Flox CLI"
</Note>
**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. Run the command for your system architecture:

1. Install the downloaded file
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
```

<Accordion title="This will replace an existing Nix installation">
Expand Down Expand Up @@ -580,16 +658,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
```
</Accordion>
<Accordion title="Debian">

Expand All @@ -601,16 +684,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
```

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
```
</Accordion>
<Accordion title="OracleLinux_8_5">

Expand All @@ -622,17 +710,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
```
</Accordion>
<Info>
**Ignore warning about systemd**
Expand Down