1# Download Nicotine+
2
3Download stable builds of Nicotine+ for your operating system.
4
5## GNU/Linux, *BSD, Solaris
6
7If you have no need to modify the Nicotine+ source, you are strongly recommended to use packages for your distribution/operating system. This will save you time.
8
9### Ubuntu/Debian
10
11To use [stable packages](https://launchpad.net/~nicotine-team/+archive/ubuntu/stable) on Ubuntu and Debian, add the stable Nicotine+ apt repository (PPA) by running the following:
12
13```sh
14sudo apt install software-properties-common
15sudo add-apt-repository ppa:nicotine-team/stable
16sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 6CEB6050A30E5769
17sudo apt update
18sudo apt install nicotine
19```
20
21If you prefer to install a .deb package directly, you can download one [here](http://ppa.launchpad.net/nicotine-team/stable/ubuntu/pool/main/n/nicotine/). Unlike the repository installation method, Nicotine+ will not update automatically; you need to download a .deb package each time a new release is available.
22
23### Fedora
24
25To install Nicotine+ on Fedora, run the following:
26
27```sh
28sudo dnf install nicotine+
29```
30
31### Flatpak
32
33If your distribution supports Flatpak, you can install Nicotine+ from Flathub.
34
35- [Download Nicotine+ on Flathub](https://flathub.org/apps/details/org.nicotine_plus.Nicotine)
36
37### Arch Linux/Manjaro/Parabola
38
39Nicotine+ is available in the community repository of Arch Linux, Manjaro and Parabola. To install, run the following:
40
41```sh
42sudo pacman -S nicotine+
43```
44
45### Void Linux
46
47To install Nicotine+ on Void Linux, run the following:
48
49```sh
50sudo xbps-install -S nicotine+
51```
52
53### FreeBSD
54
55To install Nicotine+ on FreeBSD, run the following:
56
57```sh
58pkg install py-nicotine-plus
59```
60
61### pip
62
63If Nicotine+ is not available for your system, it can be installed using [pip](https://pip.pypa.io/en/stable/). Ensure the [runtime dependencies](DEPENDENCIES.md) are installed, and run the following:
64
65```sh
66pip3 install nicotine-plus
67```
68
69Keep in mind that Nicotine+ will not auto-update. When a new release is available, run the following:
70
71```sh
72pip3 install --upgrade nicotine-plus
73```
74
75## Windows
76
77### Official Builds
78
79Stable Windows installers for Nicotine+ are available for download. Installing Nicotine+ requires administrator privileges.
80
81NOTE: The installer format has changed in Nicotine+ 3.2.0. If you are upgrading from Nicotine+ 3.1.1 or earlier, please uninstall Nicotine+ first (this will not remove your existing settings).
82
83- [64-bit Installer](https://github.com/nicotine-plus/nicotine-plus/releases/latest/download/windows-x86_64-installer.zip)  [[SHA256](https://github.com/nicotine-plus/nicotine-plus/releases/latest/download/windows-x86_64-installer.zip.sha256)]
84- [32-bit Installer](https://github.com/nicotine-plus/nicotine-plus/releases/latest/download/windows-i686-installer.zip)  [[SHA256](https://github.com/nicotine-plus/nicotine-plus/releases/latest/download/windows-i686-installer.zip.sha256)]
85
86Portable packages are also available. They can be run from your home directory, and do not require installation or administrator privileges.
87
88- [64-bit Portable Package](https://github.com/nicotine-plus/nicotine-plus/releases/latest/download/windows-x86_64-package.zip)  [[SHA256](https://github.com/nicotine-plus/nicotine-plus/releases/latest/download/windows-x86_64-package.zip.sha256)]
89- [32-bit Portable Package](https://github.com/nicotine-plus/nicotine-plus/releases/latest/download/windows-i686-package.zip)  [[SHA256](https://github.com/nicotine-plus/nicotine-plus/releases/latest/download/windows-i686-package.zip.sha256)]
90
91### Chocolatey
92
93Nicotine+ can be installed using [Chocolatey](https://community.chocolatey.org/packages/nicotine-plus). Run the following:
94
95```sh
96choco install nicotine-plus
97```
98
99## macOS
100
101### Official Builds (Catalina/10.15 and newer)
102
103A stable macOS installer for Nicotine+ is available on macOS version 10.15 (Catalina) and newer.
104
105- [Download Installer](https://github.com/nicotine-plus/nicotine-plus/releases/latest/download/macos-installer.zip)  [[SHA256](https://github.com/nicotine-plus/nicotine-plus/releases/latest/download/macos-installer.zip.sha256)]
106
107### Homebrew (Mojave/10.14 and newer)
108
109NOTE: If your Mac has an Apple M1 chip, please use the [official installer](#official-builds-catalina1015-and-newer) instead. Nicotine+ installed from Homebrew will currently not work on these devices due to issues in upstream dependencies.
110
111On macOS version 10.14 (Mojave), the recommended approach is to install Nicotine+ using [Homebrew](https://brew.sh).
112
113Once Homebrew is set up, run the following:
114
115```sh
116brew install nicotine-plus
117```
118