The workbench desktop (noVNC)
To launch the desktop, follow Lab 03, Parts 1–3. This page explains what those steps do. If the desktop page is blank or port 80 is taken, see Troubleshooting.
The workbench is a container started from IIC-OSIC-TOOLS, a toolchain image that IIC-JKU maintains. You start it with a script from the team’s workspace repo, and noVNC shows the container’s Linux desktop in your browser.
The workspace repo
You clone the workspace repo once, into a folder named workspace, and keep that clone for every later course. These are the parts IC101 uses:
Path in workspace |
Purpose |
|---|---|
scripts/start_vnc.sh / .bat |
Launches IIC-OSIC-TOOLS with noVNC |
scripts/smoke_test.sh |
Checks that the tools inside the container work |
common/.designinit |
Sets up the environment and SKY130 |
modules/ic101_setup/ |
Scratch space for this course |
pdk/ |
volare.lock, which records the PDK version the team uses. The PDK itself ships inside the image, at /foss/pdks/sky130A. |
Later courses add their own folders under modules/ with mod add <course>, a command described in What the smoke test checks.
What start_vnc does
start_vnc.sh (macOS and Linux) and start_vnc.bat (Windows) do the same three things:
- Pull the image
hpretl/iic-osic-tools:2026.08. The first run downloads several GB, which can take several minutes, and later runs reuse the copy already on your computer. - Run the container, named
asic-edu-osic, with yourworkspacefolder mounted at/foss/designs. Anything you save under/foss/designsis a file in yourworkspacefolder on your laptop, so it survives when the container is stopped or removed. - Expose the desktop at http://localhost/, on port 80 by default.
Running docker rm -f asic-edu-osic on your laptop stops and removes the container, and running start_vnc again brings it back. You’ll try both in Lab 03, Part 5.
Settings you can change
The script reads the environment variables below. You won’t need any of them in Lab 03 unless something else on your laptop is already using port 80.
| Variable | Default | What it changes |
|---|---|---|
HOST_PORT |
80 |
The port on your laptop. With HOST_PORT=8080 the desktop is at http://localhost:8080/. Use it when something else is already using port 80. |
VNC_PW |
abc123 |
The desktop password |
VNC_RESOLUTION |
1280x800 |
The desktop size, for example 1920x1080 |
DOCKER_TAG |
2026.08 |
Which image tag to pull |
On macOS and Linux you set them by putting them in front of the command, for example VNC_PW='your-password' HOST_PORT=8080 ./scripts/start_vnc.sh.
The desktop in your browser
noVNC serves a full Linux desktop in Chrome, Firefox or Edge, and the password is abc123 unless you set VNC_PW. Terminals, XSchem, Magic and the rest of the tools all open from that desktop, and they run inside the container rather than on your laptop.
Plain Ctrl+V doesn’t paste text from your laptop into the desktop. To paste there, press Ctrl+Shift+V, or use the clipboard icon in the noVNC sidebar.
X11 instead of noVNC
On Linux, or on macOS with XQuartz, ./scripts/start_x.sh shows the tools in windows on your own desktop over X11, which can be faster than streaming a whole desktop to the browser. We use noVNC in IC101 so that everyone sees the same interface.
Next: What the smoke test checks.