2023-11-13 09:33:28 -05:00
|
|
|
# sys-net
|
|
|
|
|
|
2024-01-04 11:25:16 -05:00
|
|
|
PCI handler of network devices in Qubes OS.
|
2023-11-13 09:33:28 -05:00
|
|
|
|
|
|
|
|
## Table of Contents
|
|
|
|
|
|
|
|
|
|
* [Description](#description)
|
|
|
|
|
* [Installation](#installation)
|
|
|
|
|
* [Usage](#usage)
|
|
|
|
|
|
|
|
|
|
## Description
|
|
|
|
|
|
|
|
|
|
Creates and configure qubes for handling the network devices. Qubes OS
|
|
|
|
|
provides the state "qvm.sys-net", but it will create only "sys-net", which can
|
|
|
|
|
be a disposable or not. This package takes a different approach, it will
|
|
|
|
|
create an AppVM "sys-net" and a DispVM "disp-sys-net".
|
|
|
|
|
|
2024-01-04 15:59:15 -05:00
|
|
|
By default, the chosen one is "disp-sys-net", but you can choose which qube
|
|
|
|
|
type becomes the upstream net qube "default_netvm" and the fallback target for
|
|
|
|
|
the "qubes.UpdatesProxy" service in case no rule matched before.
|
2023-11-13 09:33:28 -05:00
|
|
|
|
|
|
|
|
## Installation
|
|
|
|
|
|
|
|
|
|
Before installation, rename your current `sys-net` to another name such as
|
2024-01-04 15:59:15 -05:00
|
|
|
`sys-net-old`, the old qube will be used to install packages required for the
|
|
|
|
|
minimal template. After successful installation and testing the new net qube
|
2023-11-13 09:33:28 -05:00
|
|
|
capabilities, you can remove the old one. If you want the default net qube
|
|
|
|
|
back, just set `sys-net` template to the full template you are using, such as
|
2024-01-04 15:59:15 -05:00
|
|
|
Debian or Fedora. Before starting, turn on the `default_netvm` and check if
|
|
|
|
|
DNS is working, after that, proceed with the installation.
|
2023-11-13 09:33:28 -05:00
|
|
|
|
|
|
|
|
- Top:
|
|
|
|
|
```sh
|
|
|
|
|
qubesctl top.enable sys-net
|
|
|
|
|
qubesctl --targets=tpl-sys-net state.apply
|
|
|
|
|
qubesctl top.disable sys-net
|
2024-01-04 15:59:15 -05:00
|
|
|
qubesctl state.apply sys-net.prefs-disp
|
2023-11-13 09:33:28 -05:00
|
|
|
```
|
|
|
|
|
|
|
|
|
|
- State:
|
|
|
|
|
<!-- pkg:begin:post-install -->
|
|
|
|
|
```sh
|
|
|
|
|
qubesctl state.apply sys-net.create
|
|
|
|
|
qubesctl --skip-dom0 --targets=tpl-sys-net state.apply sys-net.install
|
2024-01-04 15:59:15 -05:00
|
|
|
qubesctl state.apply sys-net.prefs-disp
|
2023-11-13 09:33:28 -05:00
|
|
|
```
|
|
|
|
|
<!-- pkg:end:post-install -->
|
|
|
|
|
|
2024-01-04 11:25:16 -05:00
|
|
|
If you need to debug a net qube, install some helper tools:
|
|
|
|
|
```sh
|
|
|
|
|
qubesctl --skip-dom0 --targets=tpl-sys-net state.apply sys-net.install-debug
|
|
|
|
|
```
|
|
|
|
|
|
2024-01-04 15:59:15 -05:00
|
|
|
If you prefer to have an app qube as the net qube:
|
2023-11-13 09:33:28 -05:00
|
|
|
```sh
|
2024-01-04 15:59:15 -05:00
|
|
|
qubesctl state.apply sys-net.prefs
|
2023-11-13 09:33:28 -05:00
|
|
|
```
|
|
|
|
|
|
|
|
|
|
You might need to install some firmware on the template for your network
|
|
|
|
|
drivers. Check files/admin/firmware.txt.
|
|
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
|
|
|
|
|
|
A network manager is provided in `sys-net`, from there you can manager Wi-Fi
|
|
|
|
|
or Ethernet cable connections. You can also use it for network monitoring. It
|
|
|
|
|
should be relied on to hold firewall rules for other qubes, use
|
|
|
|
|
`sys-firewall`, `sys-pihole` or `sys-mirage-firewall` for that purpose.
|
