Sign in

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. Set its repository access to Create so your first push can create the repository.

Exact
Repository
Filter
Access
Tokens
list, create, and revoke access tokens

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