mirror of
https://github.com/RetroShare/RetroShare.git
synced 2024-12-26 07:59:35 -05:00
655582e970
FSFE licensing checking program lint is now happy $ reuse lint * Bad licenses: * Missing licenses: * Unused licenses: * Used licenses: AGPL-3.0-only, AGPL-3.0-or-later, Apache-2.0, CC-BY-SA-4.0, CC0-1.0, GPL-3.0-or-later, LGPL-3.0-or-later, MIT * Read errors: 0 * Files with copyright information: 6324 / 6324 * Files with license information: 6324 / 6324 Congratulations! Your project is compliant with version 3.0 of the REUSE Specification :-)
56 lines
2.1 KiB
Plaintext
56 lines
2.1 KiB
Plaintext
// SPDX-FileCopyrightText: Retroshare Team <contact@retroshare.cc>
|
|
// SPDX-License-Identifier: CC-BY-SA-4.0
|
|
|
|
= RetroShare
|
|
|
|
RetroShare is a decentralized, private, secure, cross-platform, communication
|
|
toolkit.
|
|
RetroShare provides filesharing, chat, messages, forums, channels and more.
|
|
|
|
.Build Status
|
|
|===============================================================================
|
|
|GNU/Linux, MacOS, (via travis-ci) | image:https://travis-ci.org/RetroShare/RetroShare.svg?branch=master[link="https://travis-ci.org/RetroShare/RetroShare"]
|
|
|Windows (via appveyor) | image:https://ci.appveyor.com/api/projects/status/github/RetroShare/RetroShare?svg=true[link="https://ci.appveyor.com/project/RetroShare58622/retroshare"]
|
|
|===============================================================================
|
|
|
|
|
|
== Compilation
|
|
|
|
It is very difficult to keep a comprehensive (we support many platforms) and
|
|
updated documentation on how to build RetroShare, instead we provide scripts and
|
|
recipes that are used to create the packages for the supported platforms and
|
|
more in the `build_scripts` directory of this repository.
|
|
|
|
Those packaging receipts together with the continuous integration files
|
|
`.travis.yml` and `appveyor.yml` are a good source of knowledge on how to
|
|
compile RetroShare on different platforms.
|
|
|
|
|
|
== Using RetroShare on a headless computer with WebUI
|
|
|
|
WARNING: This section is outdated need to be adapted to new WebUI
|
|
|
|
The webUI needs to be enabled as a parameter option in retroshare-service:
|
|
|
|
[source,bash]
|
|
--------
|
|
./retroshare-nogui --webinterface 9090 --docroot /usr/share/retroshare/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:
|
|
|
|
[source,bash]
|
|
--------
|
|
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.
|