Installation

Symeon Huang edited this page Jan 4, 2017 · 23 revisions

Windows

Requires 64-bit Windows.

  1. Download latest prebuilt binaries from Releases.
  2. Unpack it.
  3. Execute ss-qt5.exe

GNU/Linux

Fedora/Red Hat Enterprise Linux

The Copr builds RPMs for latest Fedora and RHEL 7. If you're using other RHEL-based distributions such as CentOS and Scientific Linux, you can just use the EPEL repo in Copr (also, please ensure you've already enabled EPEL repository).

You can enable the repo via dnf:

sudo dnf copr enable librehat/shadowsocks
sudo dnf update
sudo dnf install shadowsocks-qt5

You may need to install a dnf plugin via the command below, before you can enable copr repo using dnf.

sudo dnf install dnf-plugins-core

If your distribution doesn't have dnf, you can download the corresponding yum repo from Copr and put it under /etc/yum.repos.d/, then install shadowsocks-qt5 via yum:

sudo yum update
sudo yum install shadowsocks-qt5

Ubuntu

PPA is for Ubuntu >= 14.04.

sudo add-apt-repository ppa:hzwhuang/ss-qt5
sudo apt-get update
sudo apt-get install shadowsocks-qt5

Debian

Make sure you've installed all dependencies for building ss-qt5 by sudo apt-get install qt5-qmake qtbase5-dev libqrencode-dev libqtshadowsocks-dev libappindicator-dev libzbar-dev libbotan1.10-dev

Now run the command below, you'll get a deb package in upper directory.

dpkg-buildpackage -uc -us -b

Then, install it by sudo dpkg -i shadowsocks-qt5-<VER_ARCH_ETC>.deb.

Arch

Community

Gentoo

gentoo-zh maintained by microcai

Other distributions

Please follow instructions on compiling page to build it from source.

If you're maintaining other distributions' repository for ss-qt5, please open an issue to ask for adding it to this wiki page.

Mac OS X

Please follow instructions on compiling page to build it from source.