Documentation:Installation Guide

From RetroShare
Jump to: navigation, search
Other languages:German 100% • ‎English 100% • ‎Italian 78% • ‎Romanian 100%

Contents

Download and Install RetroShare

Windows

  1. Download the latest RetroShare release from the downloads page
  2. If RetroShare is already running, shut it down before updating: right click on the RetroShare System Tray icon, and select quit.
  3. Run the installer package or extract the portable version to a directory of your choice.

Linux

FreeBSD

Available via the ports system: http://www.freshports.org/net-p2p/retroshare

Mac OS X

Disk-Image available on the downloads page

Compile it yourself

For detailed instructions see Compile


First start

Create a Certificate and Login

The first time you start RetroShare, you have to create new Profile (technically a PGP key).

  1. Fill in the requested details
    • Name: Your username
    • Email: the email isn't important, you can just type e.g. "xxx"
    • Password: choose a strong password, it protects your profile and config files
    • Location: Some name to identify your PC, you can later create new locations for the same profile
  2. Click "Generate new Profile"
  3. You will be asked to enter your chosen password once more, to validate the Profile
  4. Retroshare should start up

Making friends

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.

Send Your Certificate to Friends

  1. Click on the "Add a Friend Wizard" Button (top button on the left-hand toolbar).
  2. Either use the "Send an Invitation by Email" function or copy the certificate manually and send it to your friends via some Chat or Email.
  3. Remember to ask your friends to send you back their certificate.

Add Your Friends to RetroShare

When you receive your friends' certificates:

  1. Click on the "Add a Friend Wizard" Button (top button on the left-hand toolbar) again.
  2. Select "Enter the certificate manually"
  3. Cut and paste their certificates into the window (only one at a time).
  4. Click "Next" Button. A window with your friend's details will appear.
  5. 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 (see FAQ). You can connect without opening your ports, too, but it will take longer and is more unreliable. It is sufficient if either you or your friend has forwarded the ports.

Use RetroShare

Communication

  • Private Chat

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.

Share files

→ Main article: Filesharing

  1. Click on the "Add Share" Button (second button from the top on the left-hand toolbar).
  2. Select the directories you want to share. The downloads directory is shared by default
    • Sharing "Network wide" means not only your friends, but also their friends can download via anonymous tunnels
    • Sharing "Browsable" means your friends can see which files you share.
      (if this is unchecked, they can find your files using the search function and download them via tunnels)
  3. Click "Close" button.

Remarks: Your shared files will not immediately appear in the directory listing. First RetroShare has to hash the files - so it knows what you are sharing. This can take 2 minutes - 1 hour depending on how many files you are sharing.


Further help can be found in the Documentation and FAQ

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.
Personal tools
Namespaces

Variants
Actions
Navigation
External websites
Wiki
Toolbox