Documentation

Ship clean install URLs for your GitHub projects

easy-install.sh gives your GitHub packages vanity URLs with built-in anonymous analytics. Docker images, shell scripts, and raw file content, all forwarded through a single, clean namespace.

Quick Start

Docker Images

Pull container images through a vanity registry URL

docker pull easy-install.sh/you/app

Shell Scripts

Pipe install scripts through a memorable URL

curl -sSL easy-install.sh/you/app/install.sh | sh

Git Clone

Clone repos through a vanity URL

git clone easy-install.sh/you/app

Content Pipes

Serve any raw file from your repo

curl -sSL easy-install.sh/you/app/config.yaml

Namespace Resolution

How URLs map to upstream sources

Command

docker pull easy-install.sh/acme/api:v2

namespace acme

GitHub username or org

→ ghcr.io/acme

project api

Repository name

→ ghcr.io/acme/api

tag :v2

Image tag or digest

→ :v2

Resolves to

ghcr.io/acme/api:v2

Reference

URL Patterns

Pattern	Mode	Resolves To
easy-install.sh/{ns}/{project}	Docker	ghcr.io/{ns}/{project}:latest
easy-install.sh/{ns}/{project}:{tag}	Docker	ghcr.io/{ns}/{project}:{tag}
easy-install.sh/{ns}/{project}	Git Clone	github.com/{ns}/{project}.git (via 307 redirect)
easy-install.sh/{ns}/{project}.git	Git Clone	github.com/{ns}/{project}.git (via 307 redirect)
easy-install.sh/{ns}/{project}/{path}	Script / Content	raw.githubusercontent.com/{ns}/{project}/HEAD/{path}