Skip to content

Quick Start

What is sigma?

Sigma is a lightweight, self-hosted OCI artifact storage and distribution system. It supports OCI artifact management, garbage collection, namespace quotas, multi-arch artifacts, and OCI image builds.

Sigma is similar to Harbor, but its distribution service is implemented by the project itself. The server, distribution process, worker, and builder can be composed for larger deployments, while simple setups can still be started with one command.

Start sigma

Let's discover sigma in less than 3 minutes.

Run sigma in Docker. If you want to use the builder, Docker version should be used the latest version. The builder will push image to server, so we should link the together, you should create network for them. And set the network name daemon.builder.docker.network in config.yaml.

# create network
docker network create sigma
# run the sigma in docker
docker run --name sigma -v /home/admin/config:/etc/sigma \
  -v /home/admin/storage:/var/lib/sigma \
  -v /var/run/docker.sock:/var/run/docker.sock -p 443:3000 \
  -d --net sigma ghcr.io/go-sigma/sigma:nightly-alpine

That's enough, now you got a service like docker hub or harbor.

Push image to sigma

bash
docker pull redis:7
docker tag redis:7 127.0.0.1:3000/library/redis:7
docker push 127.0.0.1:3000/library/redis:7