Debian Codegraph @

external/feather-docs/content/_guides/linux.md

raw
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.