Git-Mirrors/RetroShare
1
0
Fork 0
mirror of https://github.com/RetroShare/RetroShare.git synced 2024-10-01 02:35:48 -04:00
Code Issues Actions Packages Projects Releases Wiki Activity
RetroShare is a Free and Open Source cross-platform, Friend-2-Friend and secure decentralised communication platform.
7,741 Commits 63 Branches 22 Tags 194 MiB
C++ 85.6%
C 7%
QMake 1.6%
HTML 1.4%
NSIS 1%
Other 3.2%
339558f1df
Go to file
AsamK 339558f1df Update and rename README.txt to README.md 
Make README a bit nicer, with Markdown formatting and add compile dependencies for suse and arch.
2015-08-22 14:18:43 +02:00
build_scripts fixed bug in git parameter in packaging script 2015-08-16 21:44:38 -04:00
libbitdht/src Fixed uninitialized members of bdProxyId and bdConnectionRequest. 2015-06-18 10:19:36 +00:00
libresapi/src webui: allow only whitelisted link protocols to prevent javascript in links 2015-07-31 17:27:26 +02:00
libretroshare/src Added method "tableExist" to RetroDb. 2015-08-22 11:34:13 +02:00
openpgpsdk/src removed default debug flag in .pro files. Fixed up version.h in packaging script. 2015-08-02 18:35:27 +02:00
plugins Updated english translation 2015-08-08 21:14:02 +02:00
retroshare-gui/src Enabled sort by columns other than name combined with sort by state in FriendList. 2015-08-22 00:57:26 +02:00
retroshare-nogui/src changed Radix64::decode to return result as std::vector 2015-06-18 13:45:08 +00:00
rsctrl/src Added Transfer State to RPC messages 2013-04-22 22:40:30 +00:00
supportlibs/pegmarkdown Merged revision 7410 from v0.5.5 2014-06-21 21:12:27 +00:00
tests updated tests and also fixed a few bugs in using random initialisation routines 2015-01-11 22:19:32 +00:00
.gitignore added some rules to .gitignore 2015-08-05 20:53:18 +02:00
.travis.yml add travis file 2015-07-31 16:31:14 -04:00
build-all-mingw32make.bat update windows build scripts 2015-08-11 16:44:59 +02:00
README.md Update and rename README.txt to README.md 2015-08-22 14:18:43 +02:00
RetroShare.pro added web interface to retroshare-gui 2015-04-24 14:31:13 +00:00
TODO.txt Fixed layout of the ServicePermissionsPage 2015-08-08 22:46:31 +02:00

README.md

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 \
    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

    The executables produced will be:

      trunk/retroshare-gui/src/Retroshare
  trunk/retroshare-nogui/src/retroshare-nogui

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.