Get started

Installation

Install or upgrade finoctl on macOS or Linux.

Requirements

  • macOS or Linux, including a Linux cloud workspace.
  • Node.js 24 or newer.
  • The private Gallo-Fino-Wholesale-CLI-Browser-Setup-2026-11-01.zip release from your wholesale administrator. The installer includes the CLI and its dependencies.

Verify the ZIP

From inside the extracted Gallo-Fino-Wholesale-CLI-0.3.0 folder, check the contents before installing.

On macOS

Terminal
shasum -a 256 -c CLOUD-SHA256SUMS.txt

On Linux

Terminal
sha256sum -c CLOUD-SHA256SUMS.txt

The SHA-256 of the release ZIP is

Text
8b43ff164fdb588e2b6f60e676f96f310cfb7425da8a510c9c0ca3d0b280d72e

Install finoctl

Terminal
node --version
sh install.sh
export PATH="$HOME/.local/bin:$PATH"
finoctl --version
finoctl wholesale --help

The installer puts the launcher in ~/.local/bin and the versioned runtime in ~/.local/share/finoctl-runtime. Add the bin directory to your shell or agent environment to use it in new sessions. Set FINO_INSTALL_ROOT if you need a different installation directory.

Upgrade an existing install

Check the existing version first. To replace a regular launcher, run the installer with --upgrade. The installer saves a dated backup of the launcher and keeps the previous runtime. If it refuses a symlink launcher, check which installation owns it before proceeding.

Terminal
finoctl --version
sh install.sh --upgrade
finoctl --version

Connect your account

Continue to Browser sign-in. If you work from an agent session, follow Codex Cloud so the login is saved in that environment.