Settings

General

general settings logo

Startup

  • Start minimized
    Starts RetroShare directly to the Systray into the background.

For Advanced Users

  • Enable Advanced Mode (Restart required)
    Enables Advanced Settings which are hidden by default.

Misc

  • Do not show the Quit RetroShare Messagebox
    really quit interface
  • Minimize to Tray Icon
  • Auto Login
    When RetroShare is started the next time, it bypassed the question to select the User. And just starts with the actually used one.
  • Use Local Server to get new arguments
    This enables to open RetroShare links from external programs, for example if you click on a link in your Browser (e.g. Firefox ).

Idle

  • Idle Time (default 300s)
    The Status switches to "away" after not using the computer for 5 minutes.
    status

Launch Startup Wizard

launch wizard
This QuickStart wizard can help you to configure your RetroShare in a few simple steps.
If you are a more advanced user, you can access the full range of RetroShare Settings via the ToolBar.

quick start wizard
This wizard will assist you to:

  • Tell RetroShare about your internet connection
  • Choose which files you share
  • Get started using RetroShare

quick start wizard
For best performance, RetroShare needs to know a little about your connection to the internet.
For detailed explanation of network settings click here.

quick start wizard
This is a list of shared folders. You can add and remove folders using the button on the left. When you add a new folder, initially all files in that folders shared.
You can separately setup share flags for each shared directory: For detailed explanation of shared directories click here.

Network

network settings logo

Network Configuration

Network Mode

network settings logo

  • Public: DHT & Discovery
    both combined
  • Private: Discovery
    The Discovery service sends node name and ids of your trusted contacts to connected peers, to help them choose new friends. The friendship is never automatic however, and both peers still need to trust each other to allow connection. If you want to connect to a friend, but the IP and the port of your friend has changed since your last connection, it's possible to find out the new IP+Port via Discovery. A mutual friend can tell each other your new changed IP so you can connect again.
  • Inverted: DHT The DHT allows you to answer connection requests from your friends using BitTorrent's DHT. It greatly improves the connectivity. No information is actually stored in the DHT. It is only used as a proxy system to get in touch with other RetroShare nodes.
  • DarkNet: None
    This is used if neither DHT nor Discovery is wanted. Tor and I2P hidden nodes use this by default as they already have a fixed address to connect to.

Nat

network nat settings

  • Automatic (UPnP) The UPnP (Universal Plug and Play) protocol is supported by most home adsl/cable routers. With UPnP RetroShare can open itself a port at the Router to be able to listen for incoming connections.
  • Firewalled Lorem Ipsum
  • Manually Forwarded Port In your Home Router is normally an option to open Ports on their firewall. This allow others to reach your Node from the Internet.

Local Address

  • Displays your Local LAN Address, for example: 192.168.1.55
  • Internal Port on your RetroShare Node. Acceptable Port Range from 10 to 65335. Normally Ports below 1024 are reserved by your system. If possible, keep internal and external Port the same.

External Address

  • Displays the external address, your public IPv4.
  • External Port. The port where your Router is Port Forwarding to your RetroShare Node. Acceptable Port Range from 10 to 65335. Normally Ports below 1024 are reserved by your system.

Dynamic DNS

  • Dynamic DNS (DDNS or DynDNS) is a method of automatically updating a domain for non-static IP addresses. The router can update the DynDNS Provider everytime the external IP Address has changed. And Point the Domain back to your IP.
    To Set up DynDNS at your router check openwrt.org/wiki/DDNS or dd-wrt.com/wiki/DDNS. Other proprietary Router Operating Systems have similar options for DynDNS. https://freedns.afraid.org/ is a DynDNS Provider which can be used among many others.

Download Limit (KB/s)

Set the maximum traffic speed RetroShare can utilize for download. Measured in KiloBytes per second. 1 Mbit/s == 125 kByte/s

Upload Limit (KB/s)

Set the maximum traffic speed RetroShare can download for upload. Measured in KiloBytes per second. 1 Mbit/s == 125 kByte/s

Known / Previous IP's

RetroShare remembers the last 4 used internal and the last 4 used external IP's. This list can be cleared.

Show Discovery information in statusbar

Displays Information about the Discovery Service when Information is received or sent to or from friends.

Allow RetroShare to ask my ip to these websites

RetroShare ask's a few Websites to determin it's external IP address.

IP filtering

activate IP filtering

RetroShare can block unwanted IP addresses which seem to be malicious.

IP blacklist

IP whitelist

Ban every IP reported by your friends

Ban every masquerading IP reported by your DHT

Automatically ban ranges of DHT masquerading IP's starting at

Manual input

You can insert manually IP ranges to be banned or to be whitelisted.

Hidden Service Configuration

Outgoing Connections

  • Tor Socks Proxy
    This is usually 127.0.0.1/localhost and port 9050. The green light shows if outgoing connections through the proxy seem to work.
  • I2P Socks Proxy
    This is usually 127.0.0.1/localhost and port 4447.

You can connect to Hidden Nodes, even if you are running a standard Node, so why not setup Tor and/or I2P?

File Transfer

file transfer settings logo

RetroShare is capable of transferring data and search requests between peers that are not necessarily friends. This traffic however only transits through a connected list of friends and is anonymous.

You can separately setup share flags for each shared directory in the shared files dialog to be:
- Browsable by friends: files are seen by your friends.
- Anonymously shared: files are anonymously reachable through distant F2F tunnels.

  • Maximum simultaneous download
    How many downloads are allowed at the same time.
  • Default chunk strategy
    chunk strategy
    Also known as ![https://en.wikipedia.org/wiki/Segmented_file_transfer](Segmented file transfer) or swarming. With the following settings the behaviour can be influenced to fit your needs.

    • Streaming causes the transfer to request 1MB file chunks in increasing order, faciliating preview while downloading.
    • Random is purely random and favors swarming behaviour at best.
    • Progressive is a compromise, selecting the next chunk at random within less than 50 MB after the end of the partial file. That allows some randomness while preventing large empty file initialization times.
  • Safety disk space limit
    RetroShare will suspend all transfers and config file saving if the disk space goes below this limit. That prevents loss of information on some systems. A popup window will warn you when that happens.

  • Max tunnel req. forwarded per second
    This value controls how many tunnel requests your peer can forward per second.
    If you have a large internet bandwidth, you may raise this up to 30-40, to allow statistically longer tunnels to pass. Be very careful though, since this generates many small packets that can significantly slow down your own file transfer.
    The default value is 20. If you're not sure, keep it that way.

Relay

relay settings logo

By activating relays, you allow your RetroShare node to act as a bridge between RetroShare users who cannot connect directly, e.g. because they're firewalled.

You may choose to act as a relay by checking enable relay connections, or simply benefit from other peers acting as a relay, by checking use relay servers, For the former, you may specify the bandwidth allocated when acting as a relay for friends of you, for friends of your friends, or anyone in the RetroShare network.

In any case, a RetroShare node acting as a relay cannot see the relayed traffic, since it is encrypted and authenticated by the two relayed nodes.

Enable Relay Connections

Use Relay Servers

Relay Options

relay settings logo

Directories

directories settings logo

Shared Directories

  • Edit Share
    edit share
    a click on Edit Share opens the Share Manager
    share manager
    • Add to create a new shared folder
    • Edit changes permissions or directories of the share
    • Remove removes the shared directory
    • Share Folder
      share folder
      • Local Path
        Set the path in your Operation System File hierarchy
      • Virtual Folder
        Give the Share a specific name
    • Share Flags
      By clicking on the Share Flags you can enable or disable them
      • Group Flag OFF
        group flag off
        Browsing disabled for selected groups (Friends, Family, Co-Worker, etc...).
      • Group Flag ON
        group flag on
        Only direct friend nodes in selected groups can browse this directory.
      • Friend Flag OFF
        friend flag off
        Disabled browsing for direct Friends.
      • Friend Flag ON
        friend flag on
        All direct friend nodes can browse this directory.
      • Anonymous Flag OFF
        anon flag off
        Directory is not accessible by anonymous tunnels from any Friend. No one can anonymously access this directory.
      • Anonymous Flag ON
        anon flag on
        All friend nodes can relay anonymous tunnels to this directory. Directory is accessible by anonymous tunnels from any friend.
      • Example Share
        This directory is not browsable to groups or friends, but it is shared anonymously to anyone who can reach it via anonymous tunnels. Thats the default way to share files anonymously inside the network and make it reachable to Friends of Friends.
        Share Manager
  • Automatically share incomming directory (Recommended)
    Downloades are shared while downloading. If the network contains only the initial seeder, other nodes begin to request pieces via the turtle network/anon download. RetroShare nodes incorporate mechanisms to optimize their download and upload rates; for example they download pieces in a random order to increase the opportunity to exchange data, which is only possible if two peers have different pieces of the file. swarming
  • Auto-check shared directories every 10 minutes
    Shared directories are checked every 10 minutes for changes. New files are hashed and become available for friends.
  • Incoming Directory
    The downloads directory where finished downloads are put. It's recommended to share this directory to enable swarming and multi-source download of large files.
  • Partials Directory
    Unfinished Files are stored here until they are finished and get moved into the Incoming Directory.

Plugins

plugins settings logo

For security reasons, accepted plugins load automatically until the main RetroShare executable or the plugin library changes. In such case, the user needs to confirm them again. After the program is started, you can enable a plugin manually by clicking on the "Enable" button and then restart RetroShare.

If you want to develop your own plugins, contact the developers team they will be happy to help you out!

  • Authorize all plugins Check this for developing plugins. They will not be checked for the hash. However, in normal times, checking the hash protects you from malicious behaviout of crafted plugins.
  • Plugins
    plugins list
  • Plugin look-up directories
    Plugins are loaded from the directories listed in the bottom list.
    plugins directories

Notify

notify settings logo

RetroShare will notify you about what happens in your network. Depending on your usage, you may want to enable or disable some of the notifications.

Feed

News Feed

Various events can trigger a notification in your news feed.

  • Friend Connect
  • Channels
  • Forums
  • Posted
  • Messages
  • Chat
  • Security
  • Ip security
  • Feed Reader (Plugin)

With the test button, the settings can be tested how they will look like.
feed

Toasters

Various events can trigger a notification in your news feed.

  • Disable All Toasters
    If the Toasters annoy you, you can disable all at once.

Toasters

Various events can trigger a toaster in your news feed.

  • Friend Connect
  • New Message
  • Download completed
  • Private Chat
  • Group Chat
  • Chat Lobby
  • Connect attempt

With the test button, the toaster notification can be tested, how it would look like. toaster

The Toaster can be place at each corner of the screen.
toaster position

Systray

Systray Icon

There are options to show, combine and blink Systray notifications

  • Private Chat
  • Download completed
  • Chat lobbies
  • Message
  • Channel Post
  • Forum Post
  • Posted
  • FeedReader Message(Plugin)

Hovering over the tooltip shows basic information about the notification.
systray
Clicking on the systray notification shows more details about the notification.
systray

Chat Lobbies

  • Count all unread messages
  • Count all occurences of my current identity
  • Count occurences of any of the followign texts (separate by newlines)
  • case sensitive

Node

node settings logo

Node Information

Public Information

public node info

  • Name
    The Username which you have choosen at creation time of your RetroShare Account
  • Location
    Each user can have several Location were RetroShare is running. Each device could be having it's own location. For example: Linux Laptop, Windows Gaming PC, Home-Server, Raspberry Pi, Mac, ... and all of these locations can be interconnected and belong to a single user.
  • Location ID
    This is the SSLID of the Certificate from the Location
  • PGP Id
    The Userid is chained to a PGP certificate.
    The PGP-ID is the last part of the Fingerprint: FFFF GGGG HHHH IIII
  • PGP fingerprint
    Each PGP Certificate has it's own Fingerprint.
    PGP Fingerprint are structured like this: AAAA BBBB CCCC DDDD EEEE FFFF GGGG HHHH IIII

Other information

other info

  • Friend nodes
    How many Friend nodes are connected to your node offline + online
  • Software Version
    Version + revision of the Software
  • Online since
    Last time the Location cam online

Certificate

certificate

  • Include signature
  • Copy certificate to clibboard
    You can copy this text and send it to your friend via email or some other way.
  • Save certificate to file
    Export your certificate to file to send it to your friends so they can import it. The certificate includes your SSLID/Location, IP, Port, DynDNS
  • Create new node...
    Export your Certificate to create a new location with this User.

Show Statistics

node statistics

statistics

Bandwidth Details

Bandwidth
(click to enlarge)

Turtle Router Details

Turtle Router
(click to enlarge)

Global Router Details

Global Router
(click to enlarge)

RTT Details

RTT
(click to enlarge)

Certificate

People

people settings logo

Identities handling

  • automatically give "Positive" opinion to my contacts
  • Friend average opinion below which identities are banned:

Chat

Chat settings logo

General

Distant Chat

Chat Settings

  • Enable Emoticons Privat Chat
  • Enable Emoticons Group Chat
  • Enable custom fonts

  • Minimum font size

  • Enable bold
  • Enable italics
  • Minimum text contrast
  • Send message with Ctrl+Return

Chat Lobby

  • Blink tab icon
  • Default identity for chat lobbies

History

Style

Message

messages settings logo

Distant messages

  • Accept encrypted distant messages from

Reading

  • Set message to read on activate
  • Load embedded images
  • open messages in

Channels

channels settings logo

General

  • Load posts in background (Thread)

Tabs

  • Open each channel in a new tab
  • Hide tabbar with one open tab

Forum

forums settings logo

Misc

  • Set message to read on activate
  • Expand new messages
  • Load ebedded images

Tabs

  • Open each forum in a new tab
  • Hide tabbar with one open tab

Posted

posted settings logo

Tabs

  • Open each topic in a new tab
  • Hide tabbar with one open tab

Appearance

appearance settings logo

Language

Changes to language will only take effect after restarting RetroShare!

Style

Stlye Sheet

Tool Bar

Status bar

  • Compact Mode
  • Hide Sound Status
  • Hide Toaster Disabled

Sound

sound settings logo

Chatmessage

  • New Msg

Download

Friend

Permissions

permissions settings logo

Matrix

Webinterface

webinterface settings logo

  • Enable RetroShare WEB Interface

Web parameters

  • Port 9090
  • allow access from all IP adresses (Default: localhost only)

Note: these settings do not affect retroshare-nogui has a command line switch to activate the webinterface

FeedReader

feedreader settings logo

Network Configuration