Installation

Install the blobber CLI.

Installer Script

Download and install the latest release:

curl -fsSL https://blobber.meigma.dev/install.sh | sh

The script automatically:

• Detects your OS and architecture
• Verifies checksums (SHA256)
• Verifies signatures (if cosign is installed)
• Installs to ~/.local/bin (following XDG conventions)

Options

Customize the installation with environment variables:

Variable	Description	Default
BLOBBER_VERSION	Version to install	latest
BLOBBER_INSTALL	Installation directory	~/.local/bin

Install a specific version:

curl -fsSL https://blobber.meigma.dev/install.sh | BLOBBER_VERSION=1.0.0 sh

Install to a custom directory:

curl -fsSL https://blobber.meigma.dev/install.sh | BLOBBER_INSTALL=/usr/local/bin sh

tip

Ensure ~/.local/bin is in your PATH. Add this to your shell profile:

export PATH="$HOME/.local/bin:$PATH"

Homebrew

Install via Homebrew (macOS and Linux):

brew install meigma/tap/blobber

Upgrade to the latest version:

brew upgrade blobber

Scoop

Install via Scoop (Windows):

scoop bucket add meigma https://github.com/meigma/scoop-bucket
scoop install blobber

Upgrade to the latest version:

scoop update blobber

Nix

Blobber provides a Nix flake for installation and development.

Run without installing

nix run github:meigma/blobber -- --help

Install to profile

nix profile install github:meigma/blobber

Add to your flake

flake.nix

{
  inputs = {
    blobber.url = "github:meigma/blobber";
  };

  outputs = { self, blobber, ... }: {
    # Use blobber.packages.${system}.default
  };
}

Development shell

Clone the repository and enter the development environment:

git clone https://github.com/meigma/blobber.git
cd blobber
nix develop

Go

If you have Go 1.21+ installed:

go install github.com/meigma/blobber/cmd/blobber@latest

note

This installs to $GOPATH/bin (usually ~/go/bin). Ensure it's in your PATH.

From Source

Clone and build from source:

git clone https://github.com/meigma/blobber.git
cd blobber
go build -o blobber ./cmd/blobber

Move the binary to your PATH:

mv blobber ~/.local/bin/
# or
sudo mv blobber /usr/local/bin/

Verify Installation

blobber --help

Requirements

• Docker credentials configured for authenticated registries

Blobber uses your existing Docker credentials from ~/.docker/config.json. If you can docker push to a registry, blobber can too.

Next Steps

• Quickstart - Push and pull your first files
• CLI Tutorial - Learn all CLI features step-by-step