Installation/Portabilité

Installation, désinstallation, portabilité et mises à jour de KeePass 2.x.


Informations générales

Lors du téléchargement de KeePass, vous avez le choix entre trois paquets différents :

  • KeePass-2.xx-Setup.exe : le programme d'installation pour Windows.
  • KeePass-2.xx.zip : le paquet KeePass au format ZIP (version portable).
  • KeePass-2.xx-Source.zip : le code source.

Le programme d'installation et la version portable sont décrits en détail ci-dessous.

Le paquet de code source contient tout ce dont vous avez besoin pour compiler KeePass. Il comprend le code source C#/C++ et les fichiers d'en-têtes, les fichiers de ressources, les sources de construction du programme d'installation, etc.

Mise à jour de KeePass :
Quand une nouvelle version de KeePass sort, vous pouvez alors mettre à jour votre installation existante de KeePass, sans perdre aucun paramètre de configuration. Les étapes dépendent du paquet que vous utilisez (installateur ou portable), cf. ci-dessous.

Les traductions doivent également être mises à jour lorsque vous installez une nouvelle version de KeePass. Vous pouvez trouver les derniers fichiers de traduction ici : traductions de KeePass.


Le programme d'installation (fichier KeePass-2.xx-Setup.exe)

L'équipe de développement de KeePass fournit un programme d'installation qui copie KeePass sur votre disque dur, crée des raccourcis dans le menu Démarrer et associe les fichiers KDBX à KeePass, si vous le souhaitez.

De plus, KeePass est automatiquement configuré pour enregistrer ses paramètres dans le répertoire de données de l'application de l'utilisateur courant. De cette façon, plusieurs utilisateurs peuvent utiliser une installation de KeePass sans écraser les paramètres de chacun (chaque utilisateur possède son propre fichier de configuration). Le programme d'installation doit être exécuté avec les droits d'un compte administrateur, cependant KeePass s'exécute bien sans les droits d'un compte administrateur une fois qu'il est installé.

Installation :
Pour installer KeePass, exécutez le fichier KeePass-2.xx-Setup.exe et suivez l'assistant.

Mise à jour :
Exécutez le fichier KeePass-2.xx-Setup.exe. Vous n'avez pas à désinstaller auparavant l'ancienne version. Vos options de configuration ne seront pas perdues.

Désinstallation :
Pour désinstaller KeePass, exécutez le programme de désinstallation, accessible par un raccourci dans le dossier du menu Démarrer de KeePass ou dans la section programme du panneau de configuration du système. Si vous souhaitez également supprimer vos paramètres de configuration, alors vous aurez besoin de supprimer le fichier de configuration dans le répertoire de données de l'application de votre profil utilisateur (cf. configuration).

Installation silencieuse :
Le programme d’installation de KeePass, KeePass-2.xx-Setup.exe, prend en charge des paramètres de ligne de commande pour une installation silencieuse, c’est-à-dire que le programme s'installe sans demander à l'utilisateur le répertoire cible ou les options d'association. Les paramètres par défaut du programme d'installation sont utilisés.

Le paramètre de ligne de commande /SILENT effectue une installation en mode silencieux et affiche une boîte de dialogue d'état pendant le processus d'installation. Aucune question ne sera cependant posée.

Le paramètre de ligne de commande /VERYSILENT effectue une installation en mode silencieux et n'affiche pas de boîte de dialogue d'état lors du processus d'installation.

Chemin de destination :
Le programme d'installation permet de choisir le chemin de destination sur lequel KeePass est installé. Toutefois, lorsque le programme d'installation détecte une installation existante de KeePass, il suppose que l'utilisateur souhaite effectuer une mise à niveau et n'affiche donc pas la page de sélection du chemin de destination ; l'ancienne version sera remplacée par la nouvelle version. Si vous souhaitez déplacer une installation existante de KeePass vers un autre chemin, alors commencez par désinstaller l'ancienne version ; l'installateur de la nouvelle version affichera à nouveau la page de sélection du chemin de destination.

Options/composants :
Les options/composants d'installation sont expliqué(e)s en détail ici : que signifient les options/composants d'installation 2.x en détail ?


La version portable (fichier KeePass-2.xx.zip)

La version portable peut être transportée sur des appareils portables (comme des clés USB) et fonctionne sur n'importe quel ordinateur directement à partir de l'appareil, sans aucune installation. Il ne stocke rien sur votre système (contrairement au paquet d'installation, cf. ci-dessus). KeePass ne crée aucune nouvelle clé de registre et ne crée aucun fichier de configuration dans votre répertoire de données Windows ou d'application de votre profil utilisateur.

Assurez-vous que KeePass dispose d'un accès en écriture à son répertoire d'application. Sinon, le cas échéant, il essaiera d'enregistrer les options de configuration (rien de pertinent pour la sécurité) dans le répertoire de données d'application de l'utilisateur actuellement connecté (pour plus d'informations à ce sujet, cf. : configuration).

Installation :
KeePass n'a pas besoin d'être installé. Il suffit de télécharger le paquet ZIP, de le décompresser avec votre programme ZIP préféré et KeePass est prêt à être utilisé. Copiez-le à l'emplacement de votre choix (par exemple : sur votre clé USB) ; aucune configuration ou installation supplémentaire n'est nécessaire.

Mise à jour :
Téléchargez le dernier paquet portable de KeePass, décompressez-le et copiez tous les nouveaux fichiers par-dessus les anciens. Vos paramètres de configuration ne seront pas perdus (les paramètres sont stockés dans le fichier KeePass.config.xml, qui ne sera pas écrasé, car les paquets ZIP de KeePass n'incluent pas de fichier KeePass.config.xml).

Désinstallation :
Supprimer simplement le répertoire où se trouve KeePass. Cela ne laissera aucune trace de KeePass sur votre système.


Exécuter KeePass sous Mono (Linux, MacOS, BSD, etc.)

En plus de Windows, KeePass 2.x fonctionne sous Mono, c'est-à-dire Linux, MacOS, BSD, etc.

Des liens vers tous les paquets pris en charge sont disponibles sur la page des téléchargements.

  • Linux Debian/Ubuntu :
    Installez le paquet keepass2/KeePass 2.x pour Linux Debian/Ubuntu (par exemple : à l'aide de la commande apt). Un lien vers une page contenant plus d'informations sur ce paquet est disponible sur la page des téléchargements.

  • Linux Fedora :
    Installez le paquet keepass (à partir du référentiel Fedora ; lien sur la page des téléchargements).

  • Linux OpenSUSE :
    Installez le paquet keepass (à partir du référentiel Mono d'OpenSUSE ; lien sur la page des téléchargements).

  • Linux Gentoo :
    Installez le paquet keepass (depuis le dépôt Linux Gentoo ; lien sur la page des téléchargements).

  • Linux Arch :
    Installer le paquet keepass (à partir du référentiel Linux Arch ; lien sur la page des téléchargements).

  • MacOS :
    Installer le paquet KeePass 2.x pour Mac OS X (lien sur la page des téléchargements).

  • FreeBSD :
    Installer le paquet keepass (à partir de l'arborescence des portages FreeBSD ou du référentiel pkg des binaires ; lien sur la page des téléchargements).

  • Les autres systèmes Unix-like :
    Pour exécuter KeePass, procéder comme suit :
    1. Installez Mono ≥ 2.6 (les versions antérieures ne fonctionneront pas et ne sont pas prises en charge). Selon votre plateforme utilisée, les paquets à installer sont appelés mono-stable, MonoFramework, mono-devel ou mono-2.0-devel ; cf. la page du projet Mono, si vous n'êtes pas sûrs des paquets à installer.
    2. Sur certaines plateformes, l'implémentation de Windows Forms (System.Windows.Forms) est proposée dans un paquet à part. KeePass a besoin de ce paquet ; alors si vous en voyez un, installez-le également.
    3. Sur certaines plateformes, l'espace de nom Runtime (System.Runtime) est proposé sous forme de paquet à part. KeePass a besoin de ce paquet ; alors si vous en voyez un, installez-le également.
    4. Si vous souhaitez utiliser la saisie automatique sous Linux/MacOS/BSD/etc., vous avez également besoin du paquet xdotool.
    5. Téléchargez la version portable de KeePass (paquet ZIP) et décompressez-la à l'emplacement de votre choix.
    6. Lorsque vous vous trouvez dans le répertoire KeePass, exécuter la ligne de commande "mono KeePass.exe". Vous pouvez également faire un clic droit sur le fichier KeePass.exe, et choisir "Ouvrir avec une autre application" et tapez mono en tant que commande personnalisée.

Pour la dernière étape, vous pouvez créer un raccourci ou un fichier de script shell avec cette ligne de commande (utilisez un chemin absolu vers KeePass.exe, si le raccourci/fichier de script shell se trouve à un emplacement différent).

Presse-papiers :
Sur certains systèmes, les routines du presse-papiers de Mono ne fonctionnent pas correctement. Dans ce cas, installez les paquets xsel et xdotool. Si ceux-ci sont installés, KeePass les utilise pour les opérations du presse-papiers.

Saisie automatique globale :
Afin d'utiliser la saisie automatique globale, vous devez créer une touche de raccourci appropriée à l'échelle du système. Cela ne doit être fait qu'une fois manuellement. KeePass effectue la saisie automatique globale lorsqu'il est invoqué avec l'option --auto-type de la ligne de commande.

Voici quelques exemples de création d'une touche de raccourci à l'échelle du système pour la saisie automatique globale, pour différents systèmes d'exploitation :

    • KDE. Sur les systèmes Linux avec KDE, la touche de raccourci peut être créée dans Computer → System Settings → Shortcuts and Gestures: dans la boîte de dialogue, aller dans Edit → New → Global Shortcut → Command/URL, spécifié le raccourci sur l'onglet Trigger et saisissez
      mono /VotreCheminVersKeePass/KeePass.exe --auto-type
      à l'intérieur du champ Command/URL sur l'onglet Action.
    • Linux Ubuntu ≥ 11.04 (Unity/GNOME). Ouvrez la boîte de dialogue Raccourcis Clavier (Keyboard Shortcuts) dans les préférences système, cliquez sur le bouton Ajouter (Add), saisissez KeePass --auto-type comme nom et
      mono /VotreCheminVersKeePass/KeePass.exe --auto-type
      en tant que nom de commande, puis cliquez sur [Appliquer] ([Apply]). Cliquez sur Désactivé (Disabled) de l'élément nouvellement créé (tel que le texte 'Nouveau raccourci...' 'New shortcut...' s'affiche), appuyez sur Ctrl+Alt+A et fermez la boîte de dialogue.
    • Linux Ubuntu ≤ 10.10 (GNOME).
      1. Appuyez sur Alt+F2, saisissez gconf-editor et cliquez sur [OK].
      2. Naviguez vers apps → metacity → keybinding_commands.
      3. Double-cliquez sur l'un des éléments command_i, saisissez
        mono /VotreCheminVersKeePass/KeePass.exe --auto-type
        et cliquez sur [OK].
      4. Cliquez sur le nœud global_keybindings sur la gauche.
      5. Double-cliquez sur l'élément run_command_i approprié (par exemple : lorsque vous avez utilisé command_5 aux étapes précédentes, double-cliquez maintenant sur run_command_5 ) et spécifiez le raccourci clavier de votre choix. Par exemple, pour utiliser Ctrl+Alt+A comme raccourci clavier, saisissez <Control><Alt>a.

Important : pour la saisie automatique globale, la version du paquet xdotool doit être 2.20100818.3004 ou supérieure ! Si votre distribution ne propose qu'une version plus ancienne, alors vous pouvez télécharger et installer manuellement la dernière version du paquet (cf. le site xdotool).

La saisie automatique sur Wayland:
Si vous souhaitez utiliser la saisie automatique sur un système avec un compositeur Wayland, alors cf. la page la saisie automatique sur Wayland.

AES-KDF:
Pour des transformations de clé rapides utilisant AES-KDF, assurez-vous que la librairie libgcrypt est installée.

Argon2:
Pour des transformations de clé rapides utilisant Argon2, assurez-vous que la librairie libargon2 est installée.

Greffons :
Sur certains systèmes Linux, le paquet mono-complete peut être nécessaire au bon fonctionnement des greffons.

TLS 1.2 :
Pour la prise en charge de TLS 1.2, Mono 4.8.0 ou supérieur (ou .NET Framework 4.5 ou supérieur) est requis.


Exécuter KeePass sous Wine (Linux, MacOS, BSD, etc.)

Bien que vous puissiez exécuter KeePass 2.x de manière plus ou moins native sur des systèmes Unix-like en utilisant Mono (cf. ci-dessus), l'interface utilisateur n'est pas toujours jolie. Certains utilisateurs préfèrent donc exécuter KeePass 2.x sous Wine, qui fonctionne également très bien.

Pour exécuter KeePass 2.x avec Wine, procéder comme suit :

  1. Assurez-vous que Wine est installé. Généralement, le paquet à installer s'appelle wine.
  2. Assurez-vous que le Framework .NET 4.5 ou version ultérieure est installé dans Wine (cf. WineHQ AppDB: .NET Framework).
    Pour l'installation du Framework .NET 4.5 winetricks peut être utilisé (cf. WineHQ AppDB: .NET Framework 4.5).
  3. Téléchargez le dernier paquet portable de KeePass 2.x (fichier ZIP) et décompressez-le dans le répertoire de votre choix.
  4. Exécutez wine KeePass.exe.

Thème. Par défaut, Wine utilise le thème Windows classique. Si vous préférez un autre thème, vous pouvez l'installer dans 'Applications' → 'Wine' → 'Configurer Wine' ('Configure Wine)' → onglet 'Intégration au bureau' ('Desktop Integration'). Des liens vers des thèmes se trouvent par exemple sur Wikipédia: Windows XP visual styles.

Saisie automatique. Actuellement Wine n'implémente pas toutes les fonctions de l'API Windows requises pour la saisie automatique, c'est-à-dire que la saisie automatique ne fonctionne pas quand on exécute KeePass sous Wine.


Migration depuis KeePass 1.x vers 2.x

Afin de migrer KeePass depuis 1.x vers 2.x, suivre ces étapes :

  1. Installez KeePass 2.x.
    Si vous utilisez le programme d'installation, assurez-vous que le composant 'Native Support Library' est installé (par défaut ce composant est activé).
  2. Exécutez KeePass 2.x et créez un nouveau fichier de base de données (via 'Fichier' → 'Nouveau...').
  3. Importez votre ancien fichier de base de données KDB dans votre nouveau fichier de base de données KDBX (via 'Fichier' → 'Importer...', format de fichier 'KeePass KDB (1.x)').

Si tout fonctionne correctement, vous pouvez effacer votre ancienne installation de KeePass 1.x. L'ancien fichier de base de données KDB n'est également plus nécessaire, mais vous pourriez souhaiter le garder comme sauvegarde.