WebGen Linux Manual

WebGen Linux is a from-source, KVM-centric admin / workstation / hypervisor base operating system. It is built to do four things well: be a virtualisation host, see any hardware, mount anything, and browse the web.

Applications

The desktop apps — browser, files, editor, terminal, settings.

Command-line tools

wgpkg, webgen-tz, hwprobe, install — with examples.

System components

Virtualisation, storage, networking, audio, security, boot.

Packages

Every installed component, versioned and sourced (98 documented).

Securing a machine

What the Security panel reports, the tools behind it, and the changes worth making first.

Sheets — a worked budget

Income, expenses, and a surplus split between two accounts by one rate. Step by step.

Running a LAMP server

Apache + PHP-FPM + MariaDB + free TLS — serve a Laravel app over HTTPS.

GarkTank — watching packets

Capture live or open a saved file, filter with Wireshark syntax, and read a packet down to the bytes.

Running a file server

One share, reachable from macOS, Windows and Linux — SMB via the kernel, no Samba.

Getting started

Update apps: sudo wgpkg update && sudo wgpkg upgrade
See what you can install: wgpkg list --available
Connect Wi-Fi, set the clock, open the firewall: Settings.
Run a guest OS: install QEMU and give it a disk image.
Install to disk: the Install menu entry, or webgen-install.