Home

Weblab help

Help index · Project overview

Start with installation, then build a small lab using the starter exercise. These pages describe the current workspace and its supported profiles.

Release notes: v0.12.0, v0.11.1, v0.11.0, v0.10.2, v0.10.1, v0.10.0, v0.9.1, v0.9.0, v0.8.3, v0.8.2, v0.8.1, v0.8.0, v0.7.0, v0.6.0, v0.5.1. Authentication and shared instructions are available starting with v0.7.0.

User guide

External SSH access — shared device consoles and optional Internet-node jumpbox.

Optional authentication and roles — fixed accounts, login, writer/reader permissions, admin activity records and current integration limits.

1. Installation and upgrades — Docker, native Linux, KVM and remote access.
2. Images and device profiles — supported releases, ports, boot and saving.
3. Topology and window arrangement — themes, cabling, panels, zoom, fullscreen and tiling.
4. Consoles — tabs, floating windows, mobile keys, clipboard and shared input locks.
5. Instructions viewer — preview Markdown/text exercises and publish them to all stations.
6. Link failures and traffic monitoring — directional frame loss, carrier controls and packet capture.
7. Saving and restoring labs — JSON, configuration snippets, ZIP, logs, workspace reset and state precedence.
8. Creating practice labs — topology JSON contract and authoring guidance.
9. Storage monitoring — filesystem warnings, per-node usage and growth measurements.
10. AI assistants and MCP — optional agent discovery, topology previews and approved starts.
11. Agent window — optional Ollama/OpenAI conversations, previews and approved lab/console actions.
12. Troubleshooting — common setup, console, storage and networking issues.
13. Supported scope and limitations — deployment boundaries and known gaps.

Prebuilt container images and EXOS demo provide an alternative to building locally, including a wired introductory topology and bundled EXOS image.

Internet cloud — optional IPv4 NAT gateway, live outbound firewall, inbound port forwarding, DNS and return routes for Internet access from lab PCs and routers (separate prebuilt or locally built helper).

Examples and contributors

• Starter lab and JSON.
• LL2S RSTP/VLAN practice and JSON.
• FRR OSPF practice and JSON, without KVM/vendor images.
• OSPF practice and JSON.
• Development and testing.
• Agent instructions.
• Third-party notices.

An offline copy of this help is included in the source repository under docs/. The built-in Instructions viewer opens one file at a time; use Open file for another chapter.