Reference
Installer options
Installation locations, Nix modes, command options, and environment variables.
Download the installer before using the options below:
curl --fail --location https://c3pm.dev/install.sh --output install.sh
Install location
c3pm installs to this directory by default:
$HOME/.local/bin/c3pm
Installer behavior
The installer does the following:
- supports Linux x86_64;
- installs missing bootstrap tools when needed;
- downloads and verifies the latest c3pm release;
- reuses an existing Nix installation when available;
- otherwise chooses a suitable Nix setup automatically.
On a compatible systemd host, the installer prefers the multi-user Nix daemon. On other hosts it uses a single-user installation. A root environment without a compatible daemon uses nix-portable.
Options
| Option | Purpose | Environment equivalent |
|---|---|---|
--version VERSION |
Release tag to install; defaults to latest |
C3PM_VERSION |
--prefix DIRECTORY |
Installation directory; defaults to ~/.local/bin |
C3PM_INSTALL_DIR |
--nix MODE |
auto, daemon, single-user, portable, or none |
C3PM_NIX_MODE |
--yes |
Run without confirmation prompts | C3PM_YES |
--no-modify-path |
Leave ~/.profile unchanged |
C3PM_NO_MODIFY_PATH |
--dry-run |
Print the installation plan | — |
--help, -h |
Show usage | — |
# Install the current documented release to a custom directory.
sh install.sh --version v0.3.3 --prefix "$HOME/bin"
# Let c3pm manage nix-portable instead of installing system Nix.
sh install.sh --nix portable
# Install c3pm only and configure Nix later.
sh install.sh --nix none
# Preview all actions without changing the system.
sh install.sh --dry-run
For unattended installs, add --yes. To keep ~/.profile unchanged, add --no-modify-path.
sh install.sh --help
The installer can bootstrap packages through apt, dnf/yum, pacman, zypper, or apk.
Release checksums are verified before an existing c3pm binary is replaced.