Installation

pgpilot est un gestionnaire de clés graphique pour GPG. Ce guide couvre l’installation depuis les releases GitHub, via NixOS home-manager, et la compilation depuis les sources.

Prérequis

pgpilot nécessite :

• GnuPG ≥ 2.2 (la commande gpg doit être dans le PATH)
• gpg-agent (généralement inclus avec GnuPG)
• pinentry — un programme pinentry pour les invites de mot de passe (ex. pinentry-tty, pinentry-gtk2, ou pinentry-qt)

Vérifier les prérequis (Linux)

gpg --version
# La sortie doit afficher GnuPG version ≥ 2.2

gpg-agent --version
# Confirme que l'agent est disponible

which pinentry
# Doit trouver un binaire pinentry

Si gpg est absent :

• Ubuntu / Debian : sudo apt install gpg gnupg-agent pinentry
• Fedora / RHEL : sudo dnf install gnupg pinentry
• Arch : sudo pacman -S gnupg pinentry
• NixOS : voir la section NixOS ci-dessous

---

Installation depuis les releases GitHub

1. Visitez les releases pgpilot
2. Téléchargez le paquet .deb ou l’.AppImage pour votre architecture
3. Installez :

# Debian / Ubuntu
sudo dpkg -i PGPilot_x.y.z_amd64.deb

# AppImage (toute distribution)
chmod +x PGPilot_x.y.z_amd64.AppImage
./PGPilot_x.y.z_amd64.AppImage

---

NixOS / home-manager

pgpilot fournit un flake Nix avec un module home-manager. C’est la méthode d’installation recommandée sur NixOS.

1. Ajouter pgpilot aux inputs du flake

flake.nix

{
  inputs = {
    nixpkgs.url = "github:nixos/nixpkgs/nixos-unstable";
    home-manager = {
      url = "github:nix-community/home-manager";
      inputs.nixpkgs.follows = "nixpkgs";
    };
    pgpilot = {
      url = "github:gfriloux/pgpilot/v0.8.0";
      inputs.nixpkgs.follows = "nixpkgs";
    };
  };
  # ...
}

2. Importer le module home-manager

Passez inputs à votre configuration home-manager et importez le module :

# Dans votre configuration home-manager
{ inputs, ... }:
{
  imports = [ inputs.pgpilot.homeModules.pgpilot ];

  pgpilot.pgpilot.enable = true;
}

Cela installe le binaire pgpilot-app et enregistre le fichier .desktop pour votre environnement de bureau.

3. Rebuilder

sudo nixos-rebuild switch

Si le lanceur d’applications n’affiche pas pgpilot immédiatement après le rebuild, exécutez :

kbuildsycoca6 --noincremental   # KDE

Ou déconnectez-vous puis reconnectez-vous.

GnuPG sur NixOS

Assurez-vous que GnuPG et un pinentry sont dans votre environnement :

home.packages = with pkgs; [ gnupg pinentry-qt ];

---

Compilation depuis les sources

Prérequis

• Nix avec flakes activés (recommandé) — le dev shell fournit toutes les dépendances
• Rust ≥ 1.80, Node.js 22, npm, cargo-tauri, webkit2gtk si vous compilez sans Nix

Cloner le dépôt

git clone https://github.com/gfriloux/pgpilot.git
cd pgpilot

Compiler dans le dev shell Nix (recommandé)

nix develop
just build     # produit .deb et .rpm dans target/release/bundle/
just dev       # démarre Tauri + Vite en mode hot-reload

Compiler sans Nix

Installez les dépendances système de votre distribution (webkit2gtk, gtk3, libsoup3, pkg-config, clang, Node.js 22), puis :

cd app && npm install
cargo-tauri build

---

Vérification

Une fois installé, lancez pgpilot :

pgpilot-app

Une fenêtre doit apparaître. Ouvrez la page Diagnostic depuis la barre latérale — tous les contrôles doivent afficher OK ou Info. En cas d’erreur, consultez Dépannage.

---

Désinstallation

.deb

sudo dpkg -r pgpilot

# home-manager — mettez enable = false et rebuildez, ou supprimez l'option

# Pour aussi supprimer la configuration :
rm -rf ~/.config/pgpilot/

pgpilot ne modifie pas votre trousseau GPG. Vos clés restent dans ~/.gnupg/ et ne sont pas affectées par la désinstallation de pgpilot.

---

Prochaines étapes

• Lisez Démarrage rapide pour créer votre première clé
• Consultez Gestion des clés pour les workflows détaillés
• Voir Dépannage si vous rencontrez des problèmes