Skip to main content
Version: 0.4.2

Quickstart

Skipping past most of the documentation? Here's an easy to follow Quick Start Guide:

Quick Installation

# install latest release
curl -sfL https://get.hauler.dev | bash

Example Use of Hauler

Add Content to the Hauler Store

Using the Command Line:

# add a image: neuvector/scanner:latest
hauler store add image neuvector/scanner:latest

# add a image with supply chain artifacts
hauler store add image rgcrprod.azurecr.us/longhornio/longhorn-ui:v1.5.2 --key carbide-key.pub

# add a chart: rancher-stable/rancher (v2.7.9)
hauler store add chart rancher --repo https://releases.rancher.com/server-charts/stable --version 2.7.9

# add a file: rke2-install.sh
hauler store add file https://get.rke2.io --name install.sh

Using a Hauler Manifest:

hauler store sync --files hauler-manfiest.yaml
hauler-manfiest.yaml
apiVersion: content.hauler.cattle.io/v1alpha1
kind: Images
metadata:
name: hauler-content-images-example
spec:
images:
- name: neuvector/scanner:latest
- name: rgcrprod.azurecr.us/longhornio/longhorn-ui:v1.5.1
key: carbide-key.pub
---
apiVersion: content.hauler.cattle.io/v1alpha1
kind: Charts
metadata:
name: hauler-content-charts-example
spec:
charts:
- name: rancher
repoURL: https://releases.rancher.com/server-charts/stable
version: 2.7.9
---
apiVersion: content.hauler.cattle.io/v1alpha1
kind: Files
metadata:
name: hauler-content-files-example
spec:
files:
- path: https://get.rke2.io
name: install.sh

View the Hauler Store

# view and verify the content in the local hauler store
hauler store info

Save the Hauler Store

# save and export the content in the local hauler store
hauler store save --filename haul.tar.zst

airgap the haul.tar.zst to the disconnected environment


Load the Airgapped Hauler Store

# load and import the airgapped content to the new local hauler store
hauler store load haul.tar.zst

Serve the Hauler Store

# serve the content as a registry from the hauler store
hauler store serve

Copy the Hauler Store to a Registry

# copy the content to a registry from the hauler store
hauler store copy registry://harbor.example.com

Copy the Hauler Store to a Directory

# copy the content to a directory from the hauler store
hauler store copy dir://hauler-files