Getting Started

Clipper is currently offered for evaluation purposes only.

  • Docker, containerd, and podman are supported.
  • Sudo may be required when running rootful containerd or podman.
  • Push performance is not yet optimized.
  • Docker without containerd image store is significantly slower - enable containerd for best performance.

1. Install

curl -fsSL https://dl.clipper.dev/clipper-linux-amd64 -o clipper && chmod +x clipper && sudo mv clipper /usr/local/bin/
Linux x86_64Linux ARM64

2. Create a token

Sign up if you haven't already, then go to Access Tokens and create a token with all scopes enabled.

Image
Repo

Copy the token when shown.

Token created. Copy it now, you won't see it again.

clp_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6

Use with: clipper login

3. Log in

Paste your token when prompted.

clipper login

4. Push an image

clipper push myimage:latest clipper.dev/yourname/myimage:latest

Note: clipper.dev/ can be omitted, it's the default registry.

5. Pull and run

On another machine (after installing and logging in):

clipper pull yourname/myimage:latest

Then run it:

docker run clipper.dev/yourname/myimage:latest

Alternative: pull with a local tag

Pull and retag in one step - useful if you don't want the full registry prefix in your local image list.

clipper pull yourname/myimage:latest myimage:latest

Then run it:

docker run myimage:latest