RetroShare/build_scripts/Debian+Ubuntu/Linux_InstallGuide.md

Compilation on Linux

Install package dependencies:

Debian/Ubuntu

   sudo apt-get install g++ cmake libbz2-dev libjson-c-dev libssl-dev libsqlcipher-dev \
   libupnp-dev libxss-dev rapidjson-dev libbotan-2-dev libasio-dev

To compile with Qt5:

   sudo apt-get install qt5-qmake qtmultimedia5-dev qt6-5compat-dev libqt5x11extras5-dev

To compile with Qt6:

   sudo apt-get install qt6-base-dev qt6-multimedia-dev qt6-5compat-dev

Additional dependencies for Feedreader plugin:

   sudo apt-get install libxml2-dev libxslt1-dev libcurl4-openssl-dev

Additional dependencies for Voip plugin:

   sudo apt-get install libavcodec-dev libcurl4-openssl-dev \
   libqt5multimedia5-plugins libspeexdsp-dev

Autologin:

   sudo apt install libsecret-1-dev

openSUSE

   sudo zypper install git gcc-c++ cmake libqt5-qtbase-devel \
   libqt5-qtmultimedia-devel libqt5-qtx11extras-devel libbz2-devel \
   libopenssl-devel libupnp-devel libXss-devel sqlcipher-devel rapidjson-devel \
   json-c botan bzip2

Additional packages to compile with Qt6:

   sudo zypper install qt6-base-devel qt6-multimedia-devel qt6-qt5compat-devel

Additional dependencies for plugins:

   sudo zypper install ffmpeg-4-libavcodec-devel libcurl-devel libxml2-devel \
   libxslt-devel speex-devel speexdsp-devel

Linux Mint

   sudo apt-get install git g++ cmake qt5-qmake qtmultimedia5-dev \
   libqt5x11extras5-dev libupnp-dev libxss-dev libssl-dev libsqlcipher-dev \
   rapidjson-dev doxygen libbz2-dev libjson-c-dev libbotan-2-dev libasio-dev

Arch Linux

   pacman -S base-devel libgnome-keyring cmake qt5-tools qt5-multimedia qt5-x11extras \
   rapidjson libupnp libxslt libxss sqlcipher botan2 bzip2 json-c

Checkout the source code

   cd ~ 
   git clone https://github.com/RetroShare/RetroShare.git retroshare

Checkout the submodules

   cd retroshare
   git submodule update --init --remote libbitdht/ libretroshare/ openpgpsdk/ retroshare-webui/ 
   git submodule update --init --remote supportlibs/librnp supportlibs/restbed supportlibs/rapidjson

Compile

   qmake CONFIG+=release CONFIG+=rs_jsonapi CONFIG+=rs_webui
   make

The executable produced will be:

 ./retroshare-gui/src/retroshare

Install

   sudo make install

The executable produced will be:

 ~/usr/bin/RetroShare  

For packagers

Packagers can use PREFIX and LIB_DIR to customize the installation paths:

   qmake PREFIX=/usr LIB_DIR=/usr/lib64 "CONFIG-=debug" "CONFIG+=release"
   make
   make INSTALL_ROOT=${PKGDIR} install

libsqlcipher

If libsqlcipher is not available as a package

You need to place sqlcipher so that the hierarchy is:

    ~Home
      |
      +--- retroshare
      |
      +--- lib
            |
            +---- sqlcipher

	mkdir lib
	cd lib
	git clone https://github.com/sqlcipher/sqlcipher.git --depth=1 --branch v3.4.1
	cd sqlcipher
	./configure --enable-tempstore=yes CFLAGS="-DSQLITE_HAS_CODEC" LDFLAGS="-lcrypto"
	make
	cd ..

Build infos

For the FeedReader it is required to append the config option CONFIG+=retroshare_plugins. Make sure plugins/plugins.pro contains FeedReader in the list of plugins to compile.

Do not mix plugins compiled with Qt5 with those compiled with Qt6. They work only if they are compiled with the same Qt version as RetroShare.

Voip is outdated and is not compileable on the latest Debian.

For Autologin it is required to append the config option CONFIG+=rs_autologin.

Build options

• Mandatory
  • release or debug: normally you would like to use the release option
• Extra features (optional)
  • rs_autologin: enable autologin
  • retroshare_plugins: build plugins
  • rs_webui: enable Web interface
  • rs_jsonapi: enable json api interface, required by rs_webui
  • gxsthewire: enable Wire service (experimental)
  • wikipoos: enable Wiki service (experimental)
  • rs_use_native_dialogs: enable native dialogs (may cause crashes with some versions of Gtk)
  • rs_deep_channels_index: build with deep channel indexing support
  • rs_deep_files_index: build with deep file indexing support
  • "CONFIG+=..." enable other extra compile time features, you can find the almost complete list in file <sourcefolder>\retroshare.pri

Example:

qmake CONFIG-=debug CONFIG+=release CONFIG+=rs_use_native_dialog CONFIG+=rs_gui_cmark
qmake CONFIG+=rs_jsonapi CONFIG+=rs_webui CONFIG+=rs_autologin
qmake CONFIG+=rs_deep_channels_index CONFIG += gxsthewire CONFIG += wikipoos