mirror of
https://github.com/Qubes-Community/Contents.git
synced 2024-12-23 06:09:29 -05:00
79 lines
2.5 KiB
Markdown
79 lines
2.5 KiB
Markdown
Mirage Firewall
|
|
===============
|
|
|
|
A unikernel firewall for Qubes OS.
|
|
This site will help collecting information about the mirage firewall, an interesting project from "talex5".
|
|
|
|
To learn more about the Mirage Firewall, please make sure to read
|
|
|
|
- https://github.com/mirage/qubes-mirage-firewall
|
|
- https://github.com/mirage/qubes-mirage-firewall/blob/master/README.md
|
|
|
|
The Mirage Firewall for Qubes OS is a low ressource firewall, which uses a much smaller footprint
|
|
compared to the default ("fat") sys-firewall.
|
|
|
|
This page is only to write down how to build the mirage firewall for Qubes OS.
|
|
Please make sure to read the above links to understand more about it.
|
|
|
|
Most information from here has been put together reading the original docs above and following the discussion in the Qubes OS User Mailinglist / Google Groups:
|
|
https://groups.google.com/forum/#!topic/qubes-users/xfnVdd1Plvk
|
|
|
|
|
|
Build process on Qubes 4
|
|
========================
|
|
```
|
|
MirageFWBuildVM=my-mirage-buildvm
|
|
TemplateVM=fedora-29
|
|
MirageFWAppVM=sys-mirage-fw2
|
|
|
|
# create a new VM
|
|
qvm-create $MirageFWBuildVM --class=AppVM --label=red --template=$TemplateVM
|
|
|
|
|
|
# Resize private disk to 10 GB
|
|
qvm-volume resize $MirageFWBuildVM:private 10GB
|
|
|
|
# Create a symbolic link to safe docker into the home directory
|
|
qvm-run --auto --pass-io --no-gui $MirageFWBuildVM \
|
|
'sudo mkdir /home/user/var_lib_docker && \
|
|
sudo ln -s /var/lib/docker /home/user/var_lib_docker'
|
|
|
|
# Install docker and git ~2min
|
|
qvm-run --pass-io --no-gui $MirageFWBuildVM \
|
|
'sudo qvm-sync-clock && \
|
|
sudo dnf -y install docker git'
|
|
|
|
# Launch docker
|
|
qvm-run --pass-io --no-gui $MirageFWBuildVM \
|
|
'sudo systemctl start docker'
|
|
|
|
# Download and build mirage for qubes ~11min
|
|
qvm-run --pass-io --no-gui $MirageFWBuildVM \
|
|
'git clone https://github.com/mirage/qubes-mirage-firewall.git && \
|
|
cd qubes-mirage-firewall && \
|
|
git pull origin pull/52/head && \
|
|
sudo ./build-with-docker.sh'
|
|
|
|
# Copy the new kernel to dom0
|
|
cd /var/lib/qubes/vm-kernels
|
|
qvm-run --pass-io $MirageFWBuildVM 'cat qubes-mirage-firewall/mirage-firewall.tar.bz2' | tar xjf -
|
|
|
|
# create a new mirage fw appvm
|
|
qvm-create \
|
|
--property kernel=mirage-firewall \
|
|
--property kernelopts=None \
|
|
--property memory=32 \
|
|
--property maxmem=32 \
|
|
--property netvm=sys-net \
|
|
--property provides_network=True \
|
|
--property vcpus=1 \
|
|
--property virt_mode=pv \
|
|
--label=green \
|
|
--class StandaloneVM \
|
|
$MirageFWAppVM
|
|
|
|
# Change default NetVM to Mirage FW
|
|
qvm-start $MirageFWAppVM
|
|
qubes-prefs --set default_netvm $MirageFWAppVM
|
|
```
|