- Download the latest RetroShare release from the downloads page
- If RetroShare is already running, shut it down before updating: right click on the RetroShare System Tray icon, and select quit.
- Run the installer package or extract the portable version to a directory of your choice.
- Ubuntu: just follow the steps on the downloads page
- Gentoo: ebuilds are available on the retroshare overlay (documentation).
- openSUSE, Fedora: you can use this repository: http://download.opensuse.org/repositories/home:/AsamK:/RetroShare/
Development Version Install (Ubuntu)
For those using Ubuntu, and who don't wish to do the compiling but want a development version for testing. Please note that this installation is of a development version for testing and may have bugs and issues.
sudo apt-add-repository ppa:guardianproject/ppa sudo apt-add-repository ppa:csoler-users/retroshare-unstable sudo apt-get update sudo apt-get install libsqlcipher-dev sudo apt-get install retroshare06
You may need to install extra dependencies.
Available via the ports system: http://www.freshports.org/net-p2p/retroshare
Mac OS X
Disk-Image available on the downloads page
Create a Certificate and Login
The first time you start RetroShare, you have to create new Profile (technically a PGP key).
- Fill in the requested details
- Name: Your username in RetroShare
- Email: the email isn't important, you can just type e.g. "xxx" (this is not required since v0.6 version)
- Password: choose a strong password/passphrase, it protects your profile and config files (at least 20 characters with numbers and symbols)
- Location: Some name to identify your PC, because you may later create new locations for the same profile
- Click "Generate new Profile"
- You will be asked to enter your chosen password/passphrase once more, to validate the Profile
- RetroShare should start up.
As RetroShare is a Friend to Friend network you need to explicitly add friends to be able to connect to them. Once connected with them you can chat and share files. RetroShare identifies your friends with a public PGP certificate (the one that is created with your profile). In order to connect to your friends you need to exchange your certificates.
None friends ?: If you don't have friends (ie: because testing RetroShare), you should read the FAQ: "I want to test RetroShare, but don't have any real life friends using it".
Send Your Certificate to Friends
- Open the "Add a friend" wizard (RetroShare v0.6: top toolbar, button to the right "Add". RetroShare v0.5: left-hand toolbar, top button "Add a Friend").
- Either use the "Send an Invitation by Email" function, or copy the certificate manually and send it to your friends via any Chat or Email.
- Remember to ask your friends to send you back their certificate.
When you receive your friends' certificates:
- Click on the "Add a Friend Wizard" Button again (see above).
- Select "Enter the certificate manually"
- Cut and paste their certificates into the window (only one at a time).
- Click "Next" Button. A window with your friend's details will appear.
- If it looks okay - Click "Finish" Button.
Remarks: The connection will not be made until BOTH friends have added each other's certificates. As you are connecting directly to your friends and not indirectly over a server, you have to make sure the ports for RetroShare are open in your firewall and forwarded in your router. You can connect without opening your ports, but it will take longer and is more unreliable, however it is sufficient if either you or your friend has forwarded the ports.
Chatting with friends is very easy in RetroShare. Just double click on a name in the Friends list and the Chat window pops up. To select your chat avatar just click on the default blue avatar picture.
If you want to chat with several of your friends at once, you can create a "Chat lobby". On the right of the Friends list select the "Chat lobbies" tab and click the green plus. If you create a private lobby, only invited friends can join, a public lobby can be joined by all your friends.
→ Main article: Filesharing
Forums and Channels : spreading principle
After several hours (or days) some names of forums and channels will be displayed, allowing you to subscribe to these. You will only see those subscribed by your friends. This mean that to help the friends to see more forums and channels, subscribing to many forums and channels is welcome (if you have a little interrest in these subjects), if not then your friends might not have access to all the forums and channels that you see (unless a other of their friends is subscribed to).
|This page is part of RetroShare Documentation|
|Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.|