Re-working the template introduction

First changes to re-work the introduction of the fedora-minimal template
This commit is contained in:
sprig-florist 2016-11-12 18:29:45 +00:00 committed by GitHub
parent 84a1dd34f7
commit 8843982f76

View File

@ -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 <your new template name>
[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