fpcloud

The command-line interface for Fogpipe Cloud — deploy apps, manage databases, attach domains, and serve object storage.

Install

Shell (macOS / Linux)

curl -fsSL https://raw.githubusercontent.com/fogpipe/cloud-cli/main/install.sh | sh

Pin a version or install location with FPCLOUD_VERSION / FPCLOUD_INSTALL_DIR.

Homebrew

brew tap fogpipe/cloud-cli https://github.com/fogpipe/cloud-cli
brew install fogpipe/cloud-cli/fpcloud

Nix

Run it directly:

nix run github:fogpipe/cloud-cli

Or add it to your flake:

{
  inputs.fpcloud.url = "github:fogpipe/cloud-cli";
  # then, in your outputs, for a given system:
  #   fpcloud.packages.${system}.default
}

fpcloud is a proprietary (unfree) binary, so allow unfree when installing it — e.g. nixpkgs.config.allowUnfree = true, or --impure with NIXPKGS_ALLOW_UNFREE=1.

Update

Update through the channel you installed from:

Installed with	Update with
the shell script	fpcloud upgrade
Homebrew	brew upgrade fpcloud
a Nix flake input	nix flake update fpcloud, then re-enter the dev shell
nix profile install	nix profile upgrade fpcloud

fpcloud upgrade replaces the binary in place with the version your control plane advertises, so the CLI tracks the API you talk to. It only works for the shell install: a Nix-installed fpcloud lives in the read-only store and can't replace itself, so fpcloud upgrade prints the commands above instead.

Quickstart

fpcloud login                                # browser sign-in
fpcloud org use <org>                        # select your organization
fpcloud project use <project>                # select a project
fpcloud app deploy <app> --image <image>     # deploy or update an app

fpcloud --help lists everything; fpcloud <command> --help-llm prints dense, machine-readable help for a command and its subtree.

Licensing

The packaging in this repository — the install script, Nix flake/derivation, Homebrew formula, and docs — is MIT. The fpcloud binary distributed via Releases is proprietary, closed-source software governed separately by Fogpipe.