| 1 |
--- |
| 2 |
title: Installing Feather on Linux |
| 3 |
nav_title: Linux |
| 4 |
category: installation |
| 5 |
weight: 100 |
| 6 |
--- |
| 7 |
|
| 8 |
Using **TailsOS?** See the instructions [here](tails) instead. |
| 9 |
|
| 10 |
## Flatpak |
| 11 |
|
| 12 |
### Install |
| 13 |
|
| 14 |
``` |
| 15 |
flatpak install --from https://featherwallet.org |
| 16 |
``` |
| 17 |
|
| 18 |
### Verify (recommended) |
| 19 |
|
| 20 |
Authenticate the GPG key to verify that the Flatpak is genuine. |
| 21 |
|
| 22 |
``` |
| 23 |
gpg --show-keys --with-fingerprint /var/lib/flatpak/repo/feather.trustedkeys.gpg |
| 24 |
``` |
| 25 |
|
| 26 |
The output should contain a line that says: |
| 27 |
|
| 28 |
``` |
| 29 |
Key fingerprint = 8185 E158 A333 30C7 FD61 BC0D 1F76 E155 CEFB A71C |
| 30 |
``` |
| 31 |
|
| 32 |
Make sure the fingerprint shown above matches the output in your terminal. Only the letters and digits matter, you may ignore any extra or missing spaces. |
| 33 |
|
| 34 |
We recommend that you cross-check the fingerprint through the domains listed [here](release-signing-key). This way you can be confident that you obtained the correct key. |
| 35 |
|
| 36 |
If any of the fingerprints don't match: |
| 37 |
|
| 38 |
- Delete the application (`flatpak remote-delete feather`), and |
| 39 |
- [Report](report-an-issue) this incident to the developers immediately. |
| 40 |
|
| 41 |
### Run |
| 42 |
|
| 43 |
Click the shortcut in your application menu, or: |
| 44 |
|
| 45 |
``` |
| 46 |
flatpak run org.featherwallet.Feather |
| 47 |
``` |
| 48 |
|
| 49 |
--- |
| 50 |
|
| 51 |
## AppImage |
| 52 |
|
| 53 |
Download the latest AppImage for Linux from [featherwallet.org/download](https://featherwallet.org/download). |
| 54 |
|
| 55 |
### Verifying the download (optional) |
| 56 |
|
| 57 |
This section describes how to verify the AppImage file using PGP. You need a basic understanding of the Linux command line to follow the steps in this section. If you get stuck, feel free to [ask for help](report-an-issue). |
| 58 |
|
| 59 |
Download the release signing key from the [git repository](https://raw.githubusercontent.com/feather-wallet/feather/master/utils/pubkeys/featherwallet.asc). To save the file from Tor Browser: right click **→ Save Page As.. → Save**. |
| 60 |
(For alternative ways of obtaining the release signing key, see: [Release signing key](release-signing-key)) |
| 61 |
|
| 62 |
Go back to [featherwallet.org/download](https://featherwallet.org/download) and download the **signature** file for the AppImage. |
| 63 |
|
| 64 |
Place both files in the same directory as the AppImage. You should now have a folder that contains `feather-x.x.x.AppImage`, `feather-x.x.x.AppImage.asc` and `featherwallet.asc`. |
| 65 |
|
| 66 |
In a terminal, `cd` to the directory that contains the files and enter: `gpg --import featherwallet.asc` and press enter. The output should contain a line that says: |
| 67 |
|
| 68 |
``` |
| 69 |
gpg: key 0x1F76E155CEFBA71C: public key "FeatherWallet <[email protected]>" imported |
| 70 |
``` |
| 71 |
|
| 72 |
Now enter: `gpg --list-keys [email protected]` and press enter. The output should contain a line that says: |
| 73 |
|
| 74 |
``` |
| 75 |
Key fingerprint = 8185 E158 A333 30C7 FD61 BC0D 1F76 E155 CEFB A71C |
| 76 |
``` |
| 77 |
|
| 78 |
Make sure the **fingerprint** shown above matches the output in your terminal. We recommend that you also cross-check the fingerprint through the domains listed [here](release-signing-key). By cross-checking the integrity of the fingerprint across multiple domains you can be confident that you obtained the correct key. |
| 79 |
|
| 80 |
If the fingerprint does not match, do not continue the installation. Instead, [report](report-an-issue) this incident to the developers. |
| 81 |
|
| 82 |
Now enter: `gpg --verify feather-x.x.x.AppImage.asc` and press enter. Replace x.x.x with the correct version. If the signature is valid, the output should contain the following line: |
| 83 |
|
| 84 |
``` |
| 85 |
gpg: Good signature from "FeatherWallet <[email protected]>" [unknown] |
| 86 |
``` |
| 87 |
|
| 88 |
If the signature is invalid, do not continue with the installation. Instead, [report](report-an-issue) this incident to the developers immediately. |
| 89 |
|
| 90 |
### Starting Feather |
| 91 |
|
| 92 |
After the download is complete, **make sure to allow executing the file as a program**. You can often find this setting in the Properties → Permissions tab in your file explorer. Alternatively, run `chmod +x feather-x.x.x.AppImage` in a terminal. |
| 93 |
|
| 94 |
You should now be able to run the AppImage by double-clicking on the file in a file explorer. If that does not work, try right-clicking on the file, and look for "Run" or "Open". Alternatively, you can start Feather by typing `./feather-x.x.x.AppImage` in a terminal. |
| 95 |
|
| 96 |
Having trouble getting Feather to start? Please [contact](report-an-issue) the developers. |