RetroShare is a Free and Open Source cross-platform, Friend-2-Friend and secure decentralised communication platform.
Go to file
Phenom 894328b6c1 Fix default Identity on Chat
This was reseted by a new listitem after it was restored.
2015-12-30 15:57:28 +01:00
build_scripts updated ubuntu changelog 2015-12-22 17:43:37 -05:00
data
libbitdht/src Made it so that sys/select.h is only included if the operating system is not Windows 2015-12-13 08:27:32 -08:00
libresapi/src Merge pull request #218 from csoler/v0.6-ContactList 2015-12-23 18:07:10 -05:00
libretroshare/src Fix default Identity on Chat 2015-12-30 15:57:28 +01:00
msys2_build_libs
openpgpsdk/src
plugins Fix compilation for plugins but miss RetroShare-gui library linking. 2015-12-26 17:20:54 +01:00
retroshare-gui/src Merge pull request #224 from PhenomRetroShare/Fix_GenCertDialogMaskingPGPKeyPassword 2015-12-28 18:15:51 -05:00
retroshare-nogui/src Fix MacOSX 10.10 Yosemite Compilation 2015-12-22 17:27:51 +01:00
rsctrl/src
supportlibs/pegmarkdown
tests
win_build_libs
.gitignore
.travis.yml
build-all-mingw32make.bat
MacOS_X_InstallGuide.txt Update MacOS_X_InstallGuide.txt 2015-12-26 17:20:54 +01:00
README.md
retroshare.pri Fix compilation for plugins but miss RetroShare-gui library linking. 2015-12-26 17:20:54 +01:00
RetroShare.pro
Start_RetroShare-Gui_Debug.bat
TODO.txt
WindowsMSys2_InstallGuide.txt

RetroShare

RetroShare is a decentralized, private and secure commmunication and sharing platform. RetroShare provides filesharing, chat, messages, forums and channels.

Compilation on Linux

  1. Install package dependencies:

    • Debian/Ubuntu
    sudo apt-get install libglib2.0-dev libupnp-dev qt4-dev-tools \
        libqt4-dev libssl-dev libxss-dev libgnome-keyring-dev libbz2-dev \
        libqt4-opengl-dev libqtmultimediakit1 qtmobility-dev libsqlcipher-dev \
        libspeex-dev libspeexdsp-dev libxslt1-dev libcurl4-openssl-dev \
        libopencv-dev tcl8.5 libmicrohttpd-dev
    
    • openSUSE
    sudo zypper install gcc-c++ libqt4-devel libgnome-keyring-devel \
        glib2-devel speex-devel libssh-devel protobuf-devel libcurl-devel \
        libxml2-devel libxslt-devel sqlcipher-devel libmicrohttpd-devel \
        opencv-devel speexdsp-devel libupnp-devel
    
    • Arch Linux
    pacman -S base-devel libgnome-keyring libmicrohttpd libupnp libxslt \
        libxss opencv qt4 speex sqlcipher
    
  2. Checkout the source code

    mkdir ~/retroshare
    cd ~/retroshare 
    git clone https://github.com/RetroShare/RetroShare.git trunk
    
  3. Compile

    cd trunk
    qmake CONFIG+=debug
    make
    
  4. Install

    sudo make install
    

    The executables produced will be:

      /usr/bin/RetroShare06
      /usr/bin/RetroShare06-nogui
    

Compile only retroshare-nogui

If you want to run RetroShare on a server and dont need the gui and plugins, you can run the following commands to only compile/install the nogui version:

qmake
make retroshare-nogui
sudo make retroshare-nogui-install_subtargets

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

If libsqlcipher is not available as a package

You need to place sqlcipher so that the hierarchy is:

  retroshare
      |
      +--- trunk
      |
      +--- lib
            |
            +---- sqlcipher
mkdir lib
cd lib
git clone git://github.com/sqlcipher/sqlcipher.git
cd sqlcipher
./configure --enable-tempstore=yes CFLAGS="-DSQLITE_HAS_CODEC" LDFLAGS="-lcrypto"
make
cd ..

Using retroshare-nogui & webUI

The webUI needs to be enabled as a parameter option in retroshare-nogui:

./retroshare-nogui --webinterface 9090 --docroot /usr/share/RetroShare06/webui/

The webUI is only accessible on localhost:9090 (unless you canged that option in the GUI). It is advised to keep it that way so that your RS cannot be controlled using an untrusted connection.

To access your web UI from a distance, just open a SSH tunnel on it:

distant_machine:~/ >  ssh rs_host -L 9090:localhost:9090 -N

"rs_host" is the machine running retroshare-nogui. Then on the distant machine, access your webUI on

  http://localhost:9090

That also works with a retroshare GUI of course.