Installing FirmwareCI CLI

This guide covers installing and authenticating the fwci CLI tool, which you’ll use to manage FirmwareCI infrastructure in your git repositories.

Prerequisites

  • A FirmwareCI account with valid credentials
  • Git installed on your system

Installation

Download and install the fwci CLI tool for your operating system. All available downloads (including ARM64, .deb, .rpm, .apk) are listed on the downloads page.

Linux (x64):

curl -L https://fwci-cli.s3.eu-central-1.amazonaws.com/latest/fwci-latest.linux-amd64.tar.gz -o fwci-latest.linux-amd64.tar.gz
tar -xvzf fwci-latest.linux-amd64.tar.gz
sudo install -m 755 fwci-latest.linux-amd64 /usr/local/bin/fwci

Authentication

Log in using your FirmwareCI credentials. These credentials are provided by either FirmwareCI admins or the administrators of your FirmwareCI organization.

fwci login <email> <password>

Example:

$ fwci login user@example.com mypassword
Logged in as fabian.wienand@blindspot.software in git@github.com:BlindspotSoftware/test-repository.git@7a6102c

Successfully logged in as user@example.com

Self-hosted instances

If you use a self-hosted FirmwareCI instance, point the CLI to its API with the –api flag when logging in. For example:

fwci login --api https://ci.example.com/api user@example.com mypassword

Verification

Verify your installation and authentication:

$ fwci version
Logged in as fabian.wienand@blindspot.software in git@github.com:BlindspotSoftware/test-repository.git@7a6102c

FirmwareCI CLI 0.X.X

Next Steps

Now that the CLI is installed and authenticated, proceed to Repository Setup to initialize the .firmwareci infrastructure in your git repository.