From 8843982f76900e148e8fca09a6b96aff17cf4da0 Mon Sep 17 00:00:00 2001 From: sprig-florist Date: Sat, 12 Nov 2016 18:29:45 +0000 Subject: [PATCH] Re-working the template introduction First changes to re-work the introduction of the fedora-minimal template --- managing-os/templates/fedora-minimal.md | 37 +++++++++++-------------- 1 file changed, 16 insertions(+), 21 deletions(-) diff --git a/managing-os/templates/fedora-minimal.md b/managing-os/templates/fedora-minimal.md index 162e81e4..f9bbf978 100644 --- a/managing-os/templates/fedora-minimal.md +++ b/managing-os/templates/fedora-minimal.md @@ -12,35 +12,38 @@ redirect_from: Fedora - minimal ================ -The template weighs only about 300MB and has most of the stuff cut off, except for minimal X and xterm. It is really just a barebone and not even usable in this form - but you can customize it to meet your needs. You can find some usage examples in the section below. +The template only weighs about 300 MB and has only the most vital packages installed, including a minimal X and xterm installation. It is not thought to be usable in its original form. +The minimal template, however, can be easily extended to fit your requirements. The sections below contain the instructions on duplicating the template and provide some examples for commonly desired use cases. - - -Install +Installation ------- -It can be installed via the following command: +The Fedora minimal template can be installed with the following command: ~~~ [user@dom0 ~]$ sudo qubes-dom0-update qubes-template-fedora-23-minimal ~~~ -The download may take a while. +The download and installation process may take some time. -Usage +Cloning the template ----- -It is a good idea to clone the original template, and make any changes in the new clone instead: +It is higly recommended to clone the original template, and make any changes in the clone instead of the original template. The following command clones the template. Replace "your-new-clone" with your desired name. ~~~ -[user@dom0 ~]$ qvm-clone fedora-23-minimal +[user@dom0 ~]$ qvm-clone fedora-23-minimal your-new-clone ~~~ -The sudo package is not installed by default, so let's install it: +First steps +----- + +You must start the template machine in order to customize it. +A recommended first step is to install the `sudo` package, which is not installed by default in the minimal template: ~~~ -[user@F23-Minimal ~]$ su - -[user@F23-Minimal ~]$ dnf install sudo +[user@your-new-clone ~]$ su - +[user@your-new-clone ~]$ dnf install sudo ~~~ The rsyslog logging service is not installed by default. All logging is now being handled by the systemd journal. Users requiring the rsyslog service should install it manually. @@ -49,7 +52,7 @@ To access the journald log, use the `journalctl` command. ### as a NetVM -If you want to use this template for standard NetVMs you should install some more packages: +If you want to use this template to for standard NetVMs you should install some more packeges: ~~~ [user@F21-Minimal ~]$ sudo dnf install NetworkManager NetworkManager-wifi network-manager-applet wireless-tools dbus-x11 dejavu-sans-fonts tinyproxy @@ -63,14 +66,6 @@ And maybe some more optional but useful packages as well: If your network device needs some firmware then you should also install the corresponding packages as well. The `lspci` and `dnf search firmware` command will help to choose the right one :) -### as a USBVM - -If you want this template to allow USB input forwarding, you will need to install one extra package. - -~~~ -[user@F21-Minimal ~]$ sudo dnf install qubes-input-proxy-sender -~~~ - ### as a ProxyVM If you want to use this template as a ProxyVM you may want to install even more packages