Skip to content

About

A repo to hold the resources (session content, setup instructions and scripts) for an upcoming workshop on Chisel, a CLI tool to cut debs

Resources

Stars

3 stars

Watchers

0 watching

Forks

Latest commit

 

History

8 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

UbuCon India 2026: Chisel workshop resources

This repo holds the resources for the Chisel workshop at UbuCon India 2026 ("Lean, Clean & Secure: A Hands-on Intro to Chisel").

More specifically, it contains two parts:

  1. session_content/: the slides, actual slice definition files and examples for the workshop, so you can follow along and try things out on your own machine, and
  2. setup/: instructions for setting up everything you need. This second part has been broken down below.

Setup

As a participant, the process is made as simple as possible for you! At most, you'll need to perform 3 steps; in the best case, only one.

(If the venue's internet is unreliable, there is also a fully-offline path via a local cache — see the offline section below.)

Step 1: If you run Linux, ensure you have snapd installed and available.

If you use Ubuntu, you already have snapd available and ready. Proceed to Step 2.

If you use another Linux distribution, and you don't have snapd installed, please follow the instructions at https://snapcraft.io/docs/tutorials/install-the-daemon/.

(On Windows or macOS? Skip this step. You don't need snapd.)

Step 2: Ensure you have Multipass installed and available.

We'll be using Multipass to spin up an Ubuntu VM and work within this VM. This is to ensure that everyone has the same environment, and that you don't have to install anything (besides Multipass itself) on your host machine.

If you have Multipass already installed, you can skip this step — check with multipass version. Otherwise:

Linux

sudo snap install multipass

Windows

Download multipass-1.17.1+win-win64.msi from the Multipass releases page and run the installer (administrator rights required). Open a new terminal afterwards, so that multipass is on your PATH.

macOS

Download multipass-1.17.1+mac-Darwin.pkg from the Multipass releases page and run the installer package.

Verify with multipass version, then proceed to Step 3.

Step 3: Set up your dev environment with Multipass. We'll be working within this.

This has been made simple by using cloud-init (if you're curious, see here). Everything the VM needs (tools, repos and this workshop's session content itself) is installed automatically. All you've got to do is run one command in your terminal:

multipass launch 26.04 --memory 2G --disk 10G --name chisel-workshop \
  --cloud-init https://raw.githubusercontent.com/Soundarya03/chisel-workshop-resources/main/setup/cloud-init.yaml \
  --timeout 900

On Windows (PowerShell): write the command on a single line, i.e. without the \ continuations.

This downloads the Ubuntu image and kicks off the automatic setup. If Multipass reports a timeout, don't worry — the setup keeps running in the background.

Wait for the setup to finish (a few minutes), then shell into the VM:

multipass exec chisel-workshop -- cloud-init status --wait
multipass shell chisel-workshop

Check that everything is ready — inside the VM:

ls ~/.workshop-ready          # marker file left behind by the setup
snap list                     # should show lxd, rockcraft, docker and chisel
docker ps                     # should work without sudo
chisel --version
ls ~/chisel-releases ~/chisel-workshop-resources/session_content

You're all set — everything from here on happens inside this VM.


Alternative: offline setup via a local cache

If the venue's internet is unreliable, the entire setup can run off a local cache server on the conference network — no internet needed at all. The organizers will announce the cache server's address; wherever you see http://<cache-ip>:8000 below, substitute that address.

Install Multipass from the cache (replaces Step 2)

Linux

curl -fLO http://<cache-ip>:8000/installers/linux/amd64/multipass.snap
curl -fLO http://<cache-ip>:8000/installers/linux/amd64/multipass.assert
sudo snap ack multipass.assert
sudo snap install multipass.snap

Windows

Download http://<cache-ip>:8000/installers/multipass-1.17.1+win-win64.msi in your browser and run the installer (administrator rights required). Open a new terminal afterwards.

macOS

Download http://<cache-ip>:8000/installers/multipass-1.17.1+mac-Darwin.pkg in your browser and run the installer package.

Launch the VM from the cache (replaces Step 3)

First, download the VM image and the cloud-init file from the cache (quick, since it's all local):

On Intel/AMD machines (Windows, most Linux laptops, Intel Macs):

curl -fLO http://<cache-ip>:8000/images/ubuntu-26.04-server-cloudimg-amd64.img

On Apple Silicon Macs:

curl -fLO http://<cache-ip>:8000/images/ubuntu-26.04-server-cloudimg-arm64.img

Everyone (on Windows, a browser download works just as well):

curl -fLO http://<cache-ip>:8000/cloud-init-local-cache.yaml

Then, from the same directory, launch the VM:

# Intel/AMD. Apple Silicon: use the arm64 .img filename you downloaded.
multipass launch file://$PWD/ubuntu-26.04-server-cloudimg-amd64.img \
  --memory 2G --disk 10G --name chisel-workshop \
  --cloud-init cloud-init-local-cache.yaml \
  --timeout 900

Why download first? Multipass 1.17 rewrites http:// URLs to https:// when you pass them to launch, and a plain local HTTP server can't answer TLS. Launching from file:// sidesteps that completely.

On Windows (PowerShell): write the launch command on a single line (no \ continuations), and point file:// at the full path where you saved the image, e.g. file://C:/Users/you/Downloads/ubuntu-26.04-....img.

Then wait and verify exactly as in Step 3 above. Two offline-specific notes:

With no internet access, cloud-init status may report error — that's the VM image's own optional apt step failing to reach the Ubuntu archive; it does not affect the workshop setup. The reliable readiness check is the ~/.workshop-ready marker file.

Building needs internet. The setup works fully offline, but building rocks does not — rockcraft pack pulls an OCI base image (from public.ecr.aws) and Ubuntu packages (via apt) at build time, and chisel cut downloads packages too. Those are not on the local cache, so you'll need working internet once you reach the build exercises. (If the venue LAN is fully offline, flag it to the organizers — a registry mirror and an apt proxy on the cache would fix it; see setup/LOCAL-CACHE.md.)


Teardown: cleaning up afterwards

When you're done with the workshop (or want to start over with a fresh VM), delete the instance and reclaim its disk space:

multipass delete chisel-workshop
multipass purge

delete marks the instance for deletion (it stays recoverable until you purge); purge removes it permanently, along with its disk image. To do both in one step: multipass delete --purge chisel-workshop.

This only removes the VM. Anything you downloaded onto your host (the image file, the cloud-init file) can be deleted by hand if you wish, and Multipass itself can stay installed for future use.


Organizers: see setup/LOCAL-CACHE.md for what resources to prep on the local cache and how.

About

A repo to hold the resources (session content, setup instructions and scripts) for an upcoming workshop on Chisel, a CLI tool to cut debs

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages