mirror of
https://github.com/freedomofpress/dangerzone.git
synced 2025-04-28 09:52:37 +02:00
parent
10be85b9f2
commit
19fa11410b
3 changed files with 16 additions and 15 deletions
22
BUILD.md
22
BUILD.md
|
@ -187,27 +187,27 @@ Overview of the qubes you'll create:
|
||||||
|--------------|----------|---------|
|
|--------------|----------|---------|
|
||||||
| dz | app qube | Dangerzone development |
|
| dz | app qube | Dangerzone development |
|
||||||
| dz-dvm | app qube | offline disposable template for performing conversions |
|
| dz-dvm | app qube | offline disposable template for performing conversions |
|
||||||
| fedora-40-dz | template | template for the other two qubes |
|
| fedora-41-dz | template | template for the other two qubes |
|
||||||
|
|
||||||
#### In `dom0`:
|
#### In `dom0`:
|
||||||
|
|
||||||
The following instructions require typing commands in a terminal in dom0.
|
The following instructions require typing commands in a terminal in dom0.
|
||||||
|
|
||||||
1. Create a new Fedora **template** (`fedora-40-dz`) for Dangerzone development:
|
1. Create a new Fedora **template** (`fedora-41-dz`) for Dangerzone development:
|
||||||
|
|
||||||
```
|
```
|
||||||
qvm-clone fedora-40 fedora-40-dz
|
qvm-clone fedora-41 fedora-41-dz
|
||||||
```
|
```
|
||||||
|
|
||||||
> :bulb: Alternatively, you can use your base Fedora 40 template in the
|
> :bulb: Alternatively, you can use your base Fedora 40 template in the
|
||||||
> following instructions. In that case, skip this step and replace
|
> following instructions. In that case, skip this step and replace
|
||||||
> `fedora-40-dz` with `fedora-40` in the steps below.
|
> `fedora-41-dz` with `fedora-41` in the steps below.
|
||||||
|
|
||||||
2. Create an offline disposable template (app qube) called `dz-dvm`, based on the `fedora-40-dz`
|
2. Create an offline disposable template (app qube) called `dz-dvm`, based on the `fedora-41-dz`
|
||||||
template. This will be the qube where the documents will be sanitized:
|
template. This will be the qube where the documents will be sanitized:
|
||||||
|
|
||||||
```
|
```
|
||||||
qvm-create --class AppVM --label red --template fedora-40-dz \
|
qvm-create --class AppVM --label red --template fedora-41-dz \
|
||||||
--prop netvm="" --prop template_for_dispvms=True \
|
--prop netvm="" --prop template_for_dispvms=True \
|
||||||
--prop default_dispvm='' dz-dvm
|
--prop default_dispvm='' dz-dvm
|
||||||
```
|
```
|
||||||
|
@ -216,7 +216,7 @@ The following instructions require typing commands in a terminal in dom0.
|
||||||
and initiating the sanitization process:
|
and initiating the sanitization process:
|
||||||
|
|
||||||
```
|
```
|
||||||
qvm-create --class AppVM --label red --template fedora-40-dz dz
|
qvm-create --class AppVM --label red --template fedora-41-dz dz
|
||||||
qvm-volume resize dz:private $(numfmt --from=auto 20Gi)
|
qvm-volume resize dz:private $(numfmt --from=auto 20Gi)
|
||||||
```
|
```
|
||||||
|
|
||||||
|
@ -261,12 +261,12 @@ test it.
|
||||||
./install/linux/build-rpm.py --qubes
|
./install/linux/build-rpm.py --qubes
|
||||||
```
|
```
|
||||||
|
|
||||||
4. Copy the produced `.rpm` file into `fedora-40-dz`
|
4. Copy the produced `.rpm` file into `fedora-41-dz`
|
||||||
```sh
|
```sh
|
||||||
qvm-copy dist/*.x86_64.rpm
|
qvm-copy dist/*.x86_64.rpm
|
||||||
```
|
```
|
||||||
|
|
||||||
#### In the `fedora-40-dz` template
|
#### In the `fedora-41-dz` template
|
||||||
|
|
||||||
1. Install the `.rpm` package you just copied
|
1. Install the `.rpm` package you just copied
|
||||||
|
|
||||||
|
@ -274,7 +274,7 @@ test it.
|
||||||
sudo dnf install ~/QubesIncoming/dz/*.rpm
|
sudo dnf install ~/QubesIncoming/dz/*.rpm
|
||||||
```
|
```
|
||||||
|
|
||||||
2. Shutdown the `fedora-40-dz` template
|
2. Shutdown the `fedora-41-dz` template
|
||||||
|
|
||||||
### Developing Dangerzone
|
### Developing Dangerzone
|
||||||
|
|
||||||
|
@ -305,7 +305,7 @@ For changes in the server side components, you can simply edit them locally,
|
||||||
and they will be mirrored to the disposable qube through the `dz.ConvertDev`
|
and they will be mirrored to the disposable qube through the `dz.ConvertDev`
|
||||||
RPC call.
|
RPC call.
|
||||||
|
|
||||||
The only reason to build a new Qubes RPM and install it in the `fedora-40-dz`
|
The only reason to build a new Qubes RPM and install it in the `fedora-41-dz`
|
||||||
template for development is if:
|
template for development is if:
|
||||||
1. The project requires new server-side components.
|
1. The project requires new server-side components.
|
||||||
2. The code for `qubes/dz.ConvertDev` needs to be updated.
|
2. The code for `qubes/dz.ConvertDev` needs to be updated.
|
||||||
|
|
|
@ -68,6 +68,7 @@ since 0.4.1, and this project adheres to [Semantic Versioning](https://semver.or
|
||||||
Thanks [@jkarasti](https://github.com/jkarasti) for the contribution.
|
Thanks [@jkarasti](https://github.com/jkarasti) for the contribution.
|
||||||
- Work around a `cx_freeze` build issue ([#974](https://github.com/freedomofpress/dangerzone/issues/974))
|
- Work around a `cx_freeze` build issue ([#974](https://github.com/freedomofpress/dangerzone/issues/974))
|
||||||
- tests: mark the hancom office suite tests for rerun on failures ([#991](https://github.com/freedomofpress/dangerzone/pull/991))
|
- tests: mark the hancom office suite tests for rerun on failures ([#991](https://github.com/freedomofpress/dangerzone/pull/991))
|
||||||
|
- Update reference template for Qubes to Fedora 41 ([#1078](https://github.com/freedomofpress/dangerzone/issues/1078))
|
||||||
|
|
||||||
## [0.8.1](https://github.com/freedomofpress/dangerzone/compare/v0.8.1...0.8.0)
|
## [0.8.1](https://github.com/freedomofpress/dangerzone/compare/v0.8.1...0.8.0)
|
||||||
|
|
||||||
|
|
|
@ -231,8 +231,8 @@ After confirming that it matches, type `y` (for yes) and the installation should
|
||||||
|
|
||||||
> [!IMPORTANT]
|
> [!IMPORTANT]
|
||||||
> This section will install Dangerzone in your **default template**
|
> This section will install Dangerzone in your **default template**
|
||||||
> (`fedora-40` as of writing this). If you want to install it in a different
|
> (`fedora-41` as of writing this). If you want to install it in a different
|
||||||
> one, make sure to replace `fedora-40` with the template of your choice.
|
> one, make sure to replace `fedora-41` with the template of your choice.
|
||||||
|
|
||||||
The following steps must be completed once. Make sure you run them in the
|
The following steps must be completed once. Make sure you run them in the
|
||||||
specified qubes.
|
specified qubes.
|
||||||
|
@ -249,7 +249,7 @@ Create a **disposable**, offline app qube (`dz-dvm`), based on your default
|
||||||
template. This will be the qube where the documents will be sanitized:
|
template. This will be the qube where the documents will be sanitized:
|
||||||
|
|
||||||
```
|
```
|
||||||
qvm-create --class AppVM --label red --template fedora-40 \
|
qvm-create --class AppVM --label red --template fedora-41 \
|
||||||
--prop netvm="" --prop template_for_dispvms=True \
|
--prop netvm="" --prop template_for_dispvms=True \
|
||||||
--prop default_dispvm='' dz-dvm
|
--prop default_dispvm='' dz-dvm
|
||||||
```
|
```
|
||||||
|
@ -262,7 +262,7 @@ document, with the following contents:
|
||||||
dz.Convert * @anyvm @dispvm:dz-dvm allow
|
dz.Convert * @anyvm @dispvm:dz-dvm allow
|
||||||
```
|
```
|
||||||
|
|
||||||
#### In the `fedora-40` template
|
#### In the `fedora-41` template
|
||||||
|
|
||||||
Install Dangerzone:
|
Install Dangerzone:
|
||||||
|
|
||||||
|
|
Loading…
Reference in a new issue