summaryrefslogtreecommitdiff
path: root/README.rst
blob: df0d03d8e8ee018ece40b099711ed6a17ceb3859 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
===========
parabolaiso
===========

The parabolaiso project features scripts and configuration templates to build installation media (*.iso* images) for BIOS
and UEFI based systems on the x86_64 and i686 architectures.
Currently creating the images is only supported on Parabola GNU/Linux-libre.

Requirements
============

The following packages need to be installed to be able to create an image with the included scripts:

* arch-install-scripts
* dosfstools
* e2fsprogs
* libisoburn
* squashfs-tools

For running the images in a virtualized test environment the following packages are required:

* edk2-ovmf
* qemu

For linting the shell scripts the following package is required:

* shellcheck

Profiles
========

parabolaiso comes with the following profiles: **baseline**, **releng**, **releng-openrc**, **lxde-openrc** and **talkingparabola**.
They can be found below `configs/baseline/ <configs/baseline/>`_, `configs/releng/ <configs/releng/>`_,
`configs/releng-openrc/ <configs/releng-openrc/>`_, `configs/lxde-openrc/ <configs/lxde-openrc/>`_, `configs/talkingparabola/ <configs/talkingparabola/>`_
(respectively). Profiles are defined by files to be placed into overlays (e.g. *airootfs* -> *the image's /*).

Create images
=============

Usually the parabolaiso tools are installed as a package. However, it is also possible to clone this repository and create
images without installing parabolaiso system-wide.

As filesystems are created and various mount actions have to be done when creating an image, **root** is required to run
the scripts.

When parabolaiso is installed system-wide and the modification of a profile is desired, it is necessary to copy it to a
writeable location, as */usr/share/parabolaiso* is tracked by the package manager and only writeable by root (changes will
be lost on update).

The examples below will assume an unmodified profile in a system location (unless noted otherwise).

It is advised to check the help information of the **mkparabolaiso**:

  .. code:: bash

    mkparabolaiso -h

Create images with packaged parabolaiso
---------------------------------------

  .. code:: bash

    mkparabolaiso -B path/to/profile -w path/to/work_dir -o path/to/out_dir build_profile

Create images with local clone
------------------------------

Clone this repository and run:

  .. code:: bash

    ./parabolaiso/mkparabolaiso -B path/to/profile -w path/to/work_dir -o path/to/out_dir build_profile

Testing
=======

The convenience script **run_parabolaiso** is provided to boot into the medium using qemu.
It is advised to read its help information:

  .. code:: bash

    run_parabolaiso -h

Run the following to boot the iso using BIOS:

  .. code:: bash

    run_parabolaiso -i path/to/an/parabola.iso

Run the following to boot the iso using UEFI:

  .. code:: bash

    run_parabolaiso -i path/to/an/parabola.iso -u

The script can of course also be executed from this repository:


  .. code:: bash

    ./scripts/run_parabolaiso.sh -i path/to/an/parabola.iso

Installation
============

To install parabolaiso system-wide use the included **Makefile**:

  .. code:: bash

    make install

Optionally install parabolaiso's mkinitcpio hooks:

  .. code:: bash

    make install-initcpio

License
=======

parabolaiso is licensed under the terms of the **GPL-3.0-or-later** (see `LICENSE <LICENSE>`_).