mirror of https://github.com/RetroShare/RetroShare.git synced 2024-12-25 23:49:35 -05:00

RetroShare is a Free and Open Source cross-platform, Friend-2-Friend and secure decentralised communication platform.

Go to file

mr-alice 88298b997e added check for cleartext in AEAD test vector #1		2016-10-26 14:45:21 +02:00
build_scripts	updated clean.sh script to 0.6.1	2016-09-28 22:28:43 +02:00
data	Add trailing semi-colon to MimeType in .desktop files	2016-04-16 20:44:14 +02:00
libbitdht/src	Solve some compiler warnings:	2016-08-26 13:10:09 +02:00
libresapi/src	merged upstream/master	2016-09-20 20:51:50 +02:00
libretroshare/src	added check for cleartext in AEAD test vector #1	2016-10-26 14:45:21 +02:00
msys2_build_libs	Fixed MSYS2AUTOMAKE path in msys2_build_libs/Makefile	2016-08-12 14:14:09 +02:00
openpgpsdk/src	removed possible double free() of buf in parse_headers (suggestion by GuessWho)	2016-07-16 18:26:04 -04:00
plugins	Fixed Windows shadow build with Qt 5.6 or higher	2016-09-05 16:24:49 +02:00
retroshare-gui/src	Fix Windows Compilation after `6e4ba76b`	2016-09-29 12:45:01 +02:00
retroshare-nogui/src	merged upstream/master	2016-09-20 20:51:50 +02:00
rsctrl/src	updated ubuntu changelog	2015-09-21 22:58:58 -04:00
supportlibs/pegmarkdown	Fix error reported by CppChecker:	2016-03-20 13:12:30 +01:00
tests	added google test for chacha20 code	2016-10-25 14:09:39 +02:00
.gitignore	merged with upstream/master	2016-09-01 19:52:31 +02:00
.travis.yml	Updated Travis file.	2016-05-01 21:09:21 +02:00
appveyor.yml	Change Build AppVeyor State to RetroShare/RetroShare.	2016-06-19 01:40:50 +02:00
build-all-mingw32make.bat	Fix Windows 7 32b Compilation from scratch.	2015-10-17 12:15:35 +02:00
LICENSE.txt	Update and rename license.txt to LICENSE.txt	2015-12-15 09:11:12 -08:00
MacOS_X_InstallGuide.txt	Update MacOS_X_InstallGuide.txt	2015-12-26 17:20:54 +01:00
README.md	Change Build AppVeyor State to RetroShare/RetroShare.	2016-06-19 01:40:50 +02:00
retroshare.pri	Fix typos in qmake files	2016-08-31 07:41:22 +02:00
RetroShare.pro	fixed compilation "without git" as asked by ubuntu packaging	2016-07-18 23:17:22 -04:00
Start_RetroShare-Gui_Debug.bat	Fix Windows 7 32b Compilation from scratch.	2015-10-17 12:15:35 +02:00
TODO.circles.txt	updated TODO	2016-03-20 22:23:32 -04:00
TODO.txt	update todo	2016-02-24 21:51:34 +01:00
WindowsMSys2_InstallGuide.txt	Add MSys2 Install Guide	2015-10-17 12:15:36 +02:00

README.md

RetroShare

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

Build Status

Platform	Build Status
GNU/Linux, MacOS, (via travis-ci)
Windows, `MSys2` (via appveyor)

Compilation on Windows

Follow this file : WindowsMSys2_InstallGuide.txt

Compilation on MacOSX

Follow this file : MacOS_X_InstallGuide.txt

Compilation on Linux

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 libavcodec-devel

Arch Linux

pacman -S base-devel libgnome-keyring libmicrohttpd libupnp libxslt \
    libxss opencv qt4 speex sqlcipher

Checkout the source code

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

Compile
```
cd trunk
qmake CONFIG+=debug
make
```

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 don’t 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. 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.

Compile and run tests

  qmake CONFIG+=tests
  make
  tests/unittests/unittests

README.md Unescape Escape