Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
81 changes: 81 additions & 0 deletions src/content/docs/applications/development.md
Original file line number Diff line number Diff line change
Expand Up @@ -349,3 +349,84 @@ flatpak install flathub io.podman_desktop.PodmanDesktop
{{< /tabs >}}

For the full setup (including registry configuration and connecting Docker Hub and GitHub), see [Podman & Podman Desktop]({{< relref "/docs/virtualization/podman" >}}) in the Virtualization section.

### AWS CLI

Installed to reach AWS from the terminal. CloudFormation and Terraform don't need the `aws` command, but they read the same `~/.aws/` profiles it writes.

{{< tabs >}}
{{< tab name="CachyOS" >}}

AWS CLI v2 is in the `extra` repository as [aws-cli-v2](https://archlinux.org/packages/extra/any/aws-cli-v2/):

```bash
sudo pacman -S aws-cli-v2
```

It conflicts with the old v1 `aws-cli` package and provides the same `aws` command, so pacman offers to replace v1.

{{< /tab >}}
{{< tab name="Bazzite" >}}

A CLI tool with no system integration, so Homebrew rather than layering:

```bash
brew install awscli
```

{{< /tab >}}
{{< /tabs >}}

#### AWS's own installer

AWS publishes its own build as a zip, distribution-independent. This is the route the [nixCraft guide](https://www.cyberciti.biz/faq/how-to-install-aws-cli-on-linux/) takes.

Download the zip and its signature:

```bash
curl -fsSL "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o awscliv2.zip
curl -fsSL "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip.sig" -o awscliv2.sig
```

`gpg --verify` needs AWS's public key first, or it stops at `Can't check signature: No public key`. AWS publishes the key block in the [install documentation](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html). Save it as `aws-cli.asc` and import it:

```bash
gpg --import aws-cli.asc
gpg --fingerprint aws-cli@amazon.com
```

The fingerprint must be `FB5D B77F D5C1 18B8 0511 ADA8 A631 0ACC 4672 475C`, on a 4096-bit RSA key for `AWS CLI Team <aws-cli@amazon.com>`. Take the key from AWS, not from a keyserver: the copy on `keyserver.ubuntu.com` expired in July 2026 while AWS kept signing releases with it.

Verify first, install after:

```bash
gpg --verify awscliv2.sig awscliv2.zip
unzip -q awscliv2.zip
sudo ./aws/install
```

Works on Bazzite too: the installer writes to `/usr/local`, a symlink to `/var/usrlocal` on an atomic image and therefore writable. No layering, no reboot, and it survives image updates. Nothing updates it for you, so upgrading means downloading the zip again and running `sudo ./aws/install --update`.

#### Configuration

If the account uses IAM Identity Center, set up a profile against it instead of putting long-lived keys on disk:

```bash
aws configure sso
```

That opens a browser once and keeps a short-lived token, refreshed with `aws sso login`. Plain access keys still work:

```bash
aws configure
```

`aws configure sso` writes the profile to `~/.aws/config` and caches the token under `~/.aws/sso/cache/`. `aws configure` writes the access key ID and secret access key to `~/.aws/credentials` in plain text, and those don't expire. Use SSO where the account allows it.

Check the resolved identity:

```bash
aws sts get-caller-identity
```

It returns the account ID, the ARN of the user or role, and the user ID. Once that works, `aws cloudformation` and the Terraform AWS provider work too: both resolve credentials through the same profile chain. Point them at another profile with `AWS_PROFILE=name` or `--profile name`.
81 changes: 81 additions & 0 deletions src/content/docs/applications/development.nl.md
Original file line number Diff line number Diff line change
Expand Up @@ -349,3 +349,84 @@ flatpak install flathub io.podman_desktop.PodmanDesktop
{{< /tabs >}}

Voor de volledige setup (inclusief registry-configuratie en verbinding met Docker Hub en GitHub), zie [Podman & Podman Desktop]({{< relref "/docs/virtualization/podman" >}}) in de Virtualization sectie.

### AWS CLI

Geïnstalleerd om vanaf de terminal bij AWS te kunnen. CloudFormation en Terraform hebben het `aws` commando niet nodig, maar lezen wel dezelfde `~/.aws/` profielen die het wegschrijft.

{{< tabs >}}
{{< tab name="CachyOS" >}}

AWS CLI v2 zit in de `extra` repository als [aws-cli-v2](https://archlinux.org/packages/extra/any/aws-cli-v2/):

```bash
sudo pacman -S aws-cli-v2
```

Het conflicteert met het oude v1 `aws-cli` package en levert hetzelfde `aws` commando, dus pacman biedt aan v1 te vervangen.

{{< /tab >}}
{{< tab name="Bazzite" >}}

Een CLI-tool zonder systeemintegratie, dus Homebrew in plaats van layeren:

```bash
brew install awscli
```

{{< /tab >}}
{{< /tabs >}}

#### AWS' eigen installer

AWS publiceert zijn eigen build als zip, distributie-onafhankelijk. Dit is de route die de [nixCraft guide](https://www.cyberciti.biz/faq/how-to-install-aws-cli-on-linux/) neemt.

Download de zip en de signature:

```bash
curl -fsSL "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o awscliv2.zip
curl -fsSL "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip.sig" -o awscliv2.sig
```

`gpg --verify` heeft eerst de public key van AWS nodig, anders stopt het met `Can't check signature: No public key`. AWS publiceert het keyblok in de [installatiedocumentatie](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html). Bewaar het als `aws-cli.asc` en importeer het:

```bash
gpg --import aws-cli.asc
gpg --fingerprint aws-cli@amazon.com
```

De fingerprint moet `FB5D B77F D5C1 18B8 0511 ADA8 A631 0ACC 4672 475C` zijn, op een 4096-bit RSA-key van `AWS CLI Team <aws-cli@amazon.com>`. Haal de key bij AWS, niet van een keyserver: de kopie op `keyserver.ubuntu.com` verliep in juli 2026 terwijl AWS er releases mee bleef ondertekenen.

Eerst verifiëren, daarna pas installeren:

```bash
gpg --verify awscliv2.sig awscliv2.zip
unzip -q awscliv2.zip
sudo ./aws/install
```

Werkt ook op Bazzite: de installer schrijft naar `/usr/local`, op een atomic image een symlink naar `/var/usrlocal` en dus schrijfbaar. Geen layering, geen reboot, en het overleeft image-updates. Niets werkt het voor je bij, dus upgraden betekent de zip opnieuw downloaden en `sudo ./aws/install --update` draaien.

#### Configuratie

Gebruikt het account IAM Identity Center, zet dan een profiel daartegen op in plaats van langlevende keys op schijf:

```bash
aws configure sso
```

Dat opent één keer een browser en houdt een kortlevend token bij, dat je met `aws sso login` ververst. Gewone access keys werken ook:

```bash
aws configure
```

`aws configure sso` schrijft het profiel naar `~/.aws/config` en cachet het token onder `~/.aws/sso/cache/`. `aws configure` schrijft de access key ID en secret access key in platte tekst naar `~/.aws/credentials`, en die verlopen niet. Gebruik SSO waar het account dat toelaat.

Controleer de opgeloste identiteit:

```bash
aws sts get-caller-identity
```

Dat geeft het account-ID, de ARN van de user of role, en het user-ID terug. Werkt dat, dan werken `aws cloudformation` en de Terraform AWS provider ook: allebei lossen ze credentials op via dezelfde profielketen. Wijs ze naar een ander profiel met `AWS_PROFILE=naam` of `--profile naam`.
14 changes: 13 additions & 1 deletion src/content/docs/applications/productivity.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ flatpak install flathub org.signal.Signal

### Proton Mail

Proton Mail desktop app is a wrapper around the web app rather than a native client. On CachyOS the [repository](https://packages.cachyos.org/package/cachyos/any/proton-mail-bin) ships `proton-mail-bin`, which integrates more natively into the desktop than the Flatpak: better tray icon behavior, system notifications, and no Flatpak sandbox overhead. On Bazzite the Flatpak is the option.
Proton Mail desktop app is a wrapper around the web app rather than a native client. On CachyOS the [repository](https://packages.cachyos.org/package/cachyos/any/proton-mail-bin) ships `proton-mail-bin`, which integrates more natively into the desktop than the Flatpak: better tray icon behavior, system notifications, and no Flatpak sandbox overhead.

**CachyOS / Arch (recommended):**

Expand All @@ -47,6 +47,18 @@ flatpak install flathub me.proton.Mail

![Proton Mail app in Flathub](/images/protonmail-flathub.avif)

#### Proton's own .rpm

Proton publishes a `.deb` and an `.rpm` itself, linked from [its Linux setup article](https://proton.me/support/set-up-proton-mail-linux). On ordinary Fedora, install it with dnf:

```bash
sudo dnf install ./ProtonMail-desktop-*.rpm
```

That gives you dependency handling and a clean `dnf remove`, but not updates. No Proton repository sits behind the file, so nothing shows up in `dnf upgrade` and every release means downloading the RPM again.

Bazzite has no `dnf` on the host, so the same file means `rpm-ostree install` on a local RPM: a layered package and a reboot, repeated per release. The [WinBoat]({{< relref "/docs/virtualization/winboat" >}}) page runs into the same thing. The Flatpak updates in the background and costs no reboots, so it stays the better option on Bazzite.

### Standard Notes

Standard Notes is part of the Proton ecosystem, with the same privacy-first philosophy as Proton Mail and end-to-end encrypted notes that sync across all your devices. It was [acquired by Proton in 2022](https://proton.me/blog/proton-standard-notes-join-forces).
Expand Down
14 changes: 13 additions & 1 deletion src/content/docs/applications/productivity.nl.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ flatpak install flathub org.signal.Signal

### Proton Mail

Proton Mail desktop app is een wrapper rond de web app in plaats van een native client. Op CachyOS levert de [repository](https://packages.cachyos.org/package/cachyos/any/proton-mail-bin) `proton-mail-bin`, die sneller integreert dan de Flatpak: beter tray icon behavior, system notifications, en geen Flatpak sandbox overhead. Op Bazzite is de Flatpak de optie.
Proton Mail desktop app is een wrapper rond de web app in plaats van een native client. Op CachyOS levert de [repository](https://packages.cachyos.org/package/cachyos/any/proton-mail-bin) `proton-mail-bin`, die sneller integreert dan de Flatpak: beter tray icon behavior, system notifications, en geen Flatpak sandbox overhead.

**CachyOS / Arch (aanbevolen):**

Expand All @@ -47,6 +47,18 @@ flatpak install flathub me.proton.Mail

![Proton Mail app in Flathub](/images/protonmail-flathub.avif)

#### Proton's eigen .rpm

Proton publiceert zelf een `.deb` en een `.rpm`, te vinden via [hun Linux setup-artikel](https://proton.me/support/set-up-proton-mail-linux). Op gewone Fedora installeer je dat met dnf:

```bash
sudo dnf install ./ProtonMail-desktop-*.rpm
```

Dat levert dependency-afhandeling en een schone `dnf remove` op, maar geen updates. Er zit geen Proton-repository achter het bestand, dus er verschijnt niets in `dnf upgrade` en elke release betekent de RPM opnieuw downloaden.

Bazzite heeft geen `dnf` op de host, dus hetzelfde bestand betekent daar `rpm-ostree install` op een lokale RPM: een gelayerd package en een reboot, en dat bij elke release opnieuw. De [WinBoat]({{< relref "/docs/virtualization/winboat" >}}) pagina loopt tegen hetzelfde aan. De Flatpak update op de achtergrond en kost geen reboots, dus op Bazzite blijft die de betere optie.

### Standard Notes

Standard Notes maakt deel uit van het Proton-ecosysteem, met dezelfde privacy-first filosofie als Proton Mail en end-to-end versleutelde notities die op al je apparaten synnen. Het werd [in 2022 overgenomen door Proton](https://proton.me/blog/proton-standard-notes-join-forces).
Expand Down
Loading