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:
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, andsetup/: instructions for setting up everything you need. This second part has been broken down below.
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.)
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.)
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 multipassWindows
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.
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 900On 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-workshopCheck 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_contentYou're all set — everything from here on happens inside this VM.
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.
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.snapWindows
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.
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.imgOn Apple Silicon Macs:
curl -fLO http://<cache-ip>:8000/images/ubuntu-26.04-server-cloudimg-arm64.imgEveryone (on Windows, a browser download works just as well):
curl -fLO http://<cache-ip>:8000/cloud-init-local-cache.yamlThen, 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 900Why download first? Multipass 1.17 rewrites
http://URLs tohttps://when you pass them tolaunch, and a plain local HTTP server can't answer TLS. Launching fromfile://sidesteps that completely.On Windows (PowerShell): write the launch command on a single line (no
\continuations), and pointfile://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 statusmay reporterror— 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-readymarker file.
Building needs internet. The setup works fully offline, but building rocks does not —
rockcraft packpulls an OCI base image (frompublic.ecr.aws) and Ubuntu packages (via apt) at build time, andchisel cutdownloads 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; seesetup/LOCAL-CACHE.md.)
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 purgedelete 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.