Installation

.deb based installation (Ubuntu, Debian) - DEFAULT

Follow the the these instructions as root. (on Ubuntu root is not enabled by default, you can enable it with: sudo passwd root)

1. Add the following line to /etc/apt/source.list:  deb http://www.turtle4privacy.org/pkg_x86/bin /

For example in a terminal type:
echo "deb http://www.turtle4privacy.org/pkg_x86/ bin/" >> /etc/apt/sources.list

2. Update the system with: apt-get update

3. Then install Turtle using command line or Synaptic.
For example in a terminal type: apt-get install apollon4turtle
After this step giFT, the Turtle plugin and all the needed libraries will be installed. The Apollon4Turtle client and the configuration plug-in will also being installed.
Note: Ignore any warning if the installer complains about a gpg signature.

Important: The standard Apollon client does not directly support the Turtle configuration interface. In order to support Turtle-specific operations (adding friends, configuring keys, etc.) we have modified the Apollon client. In order to be able to use the Turtle configuration interface you need to install the (modified) Apollon distribution provided on this site.  
If you already have an  Apollon version installed, please remove it before upgrading to Turtle.

4. Once all these packages have been installed, you need to configure your Turtle client.

5. Enjoy the freedom of sharing with Turtle!

Important: Turtle is a client-server application. When running it, it should be possible for other Turtle nodes (e.g. your friends) to connect to your node. If you run a firewall, you need to open two ports in it (corresponding to the listening ports you configured for your node) to allow incoming connections from friend Turtle nodes. See the Firewall Configuration section for more details.

http://opensuse.org

Not all distiributions rely on .deb packages and apt for managing software and dependencies, in fact, if you are here it means that yours doesn't!  For example Fedora and OpenSUSE don't support directly the possibilty of installing software via apt, predderring other tools like YaST or Yum.

Anyway the good news is that virtually all of this distros also give the possibility of installing apt, thus allowing you to install Turtle with the above method.  Here you can have a look for instruction if you are a OpenSUSE or Fedora user.

Installation for Windows

A windows installer is NOT available at this stage of development.

To configure, see the descriptions below for an installation on GNU/Linux.

See the User Manual as well.

Configuring the Turtle Client

Using the Turtle configuration interface  (Apollon4Turtle)
After the installation process is completed, you need to run /usr/local/kde/bin/apollon, which provides a first-time-run installation wizard. You will be required to provide a user name for your Turtle node (the name used by your friends to contact you). You input your Turtle node name in the What's your username? text box of the Turtle installation wizard.

Once the main Apollon window is displayed, you can further configure your Turtle node by going to Settings → Configure Apollon → Advanced → Turtle → Configure. This will display the main Turtle configuration window. Fill in the fields there as follows:
Setup your Turtle node IP address by filling the appropriate boxes in the Turtle Node Address input field in the Configure Turtle Plugin dialog. If you select 0.0.0.0 Turtle will be visible on all IP addresses on your host.
Setup the Turtle TCP port by filling the Turtle Node Port input field in the Configure Turtle Plugin dialog. By default this is port 1391.
Setup the port where Turtle listens for key agreement requests from your friends, by filling the Key Agreement Listener Port input field in the Configure Turtle Plugin dialog. By default this is port 4242.

Add and configure friend nodes:
You can add new friend nodes by clicking on the Add button in the Configure Turtle Plugin dialog. This opens a new Friend Node Settings dialog, where you can fill in the details about the friend node:
1. The name of the friend node, which you can fill in the Friend Node Name input field.
2. The IP address of the friend node, which you can fill in the Friend Node Address input field.
3. The Turtle TCP port for the friend node, which you can fill in the Friend Node Port input field.
4. The key agreement port for the friend node, which you can fill in the Friend Key Agreement Listener Port input field.

Once a friend has been added, you can setup a shared key for authenticating to it, by selecting the friend from the Friend Nodes list in the Configure Turtle Plugin dialog, and then clicking on the Edit button, which opens again the Friend Node Settings dialog:

You can directly type a shared key in the Friend Node Key input field. In this case, you need to agree on this key by out of band means (for example by meeting your friend in person). The shared key is represented as a 32 digits hex number. Important: although not particularly user-friendly, for the time being, this is key agreement method should be used for the majority of Linux distributions (with the exception of Suse and Mandiva). The more user-friendly interactive key agreement mechanism (described next) is not yet stable, and is not guaranteed to work on all platforms.

You can generate a new key by performing an interactive key agreement protocol with your friend (important: only use this mechanism on Suse and Mandiva platforms. For all the other Linux platforms you need to type in the shared key). To start, you click on the Connect button in the Friend Node Settings dialog. This will display a new KeyAgreement Dialog window. The interactive key agreement protocol takes place inside this window. The new key is created incrementally, through an interactive questions and answers session.

You and your friend will in turn ask questions for which you both know the answer (Example - "What is the name of our high school math teacher?"). You can select sample questions from the Possible questions dropbox. If the answers you provide match, they are computed into the shared key. The strength of the key depends on the number of questions/answers you submit. If you don't know an answer to a question, push the Don't Know button; your friend has the choice to send you another question, or abort the agreement. In order to have a secure key, it is important that answers depend on shared knowledge between you and your friend (it should be hard for a stranger to guess these answers!).

Once a friend node has been added, and a shared key has been agreed upon, the Turtle software will automatically connect to the friend node, and establish a secure encrypted channel to it. This channel is then used for sending queries and receiving query results. 

Firewall/Router Configuration
Turtle is a client-server application. Before running it, you should ensure that it is possible for other Turtle nodes (e.g. your friends) to connect to your node. If you run a firewall or are behind a router (i.e. wireless), you need to configure it in such a way that incoming connection requests for the Turtle Node Port and for the Turtle Key Agreement Listener Port (KALP) are allowed to pass through. This ensures that friend nodes can connect to your node. These two ports are the ones you set when you configured your Turtle node.

SO, in order to get the best performance out of Turtle, please poke a hole in your firewall/router to allow these ports to be forwarded.
Default: TCP 4242 and TCP 1391

Manual configuration  (DEPRECATED)
If you have not installed the Turtle configuration interface, you need to configure Turtle manually. Download the script and from the command line, type:
gift-turtle-ccfg.sh
This will execute the Turtle configuration script, which will generate a skeleton Turtle configuration file. This file is placed in ~/.giFT/Turtle/Turtle.conf. You need to manually edit this file as follows:
Set your Turtle node name in the [main]:myName field.
Add your friend nodes in the [neighbours] section. Each friend is described by a set of attribute-value pairs of the form friend_number/attribute_name = attribute_value. For each friend you need to specify the following attributes:
name -- the name chosen by your friend for her Turtle node.
address -- the IP address and port of your friend node (in the form address:port.
kalp -- the key agreement port for the friend node.
key -- the key shared between you and your friend (in this case you need to agree on this key by out of band means).
Set your node IP address and port in the [tcp]:myAddress field. The format is address:port. If you specify 0.0.0.0 as the IP address, Turtle will be visible on all IP addresses on your host.
Set the port where Turtle listens for key agreement requests from your friends in the in the [tcp]:keyAgreementListenerPort field. Note: in this case you will not be capable of running the interactive key agreement protocol (since you have not installed the Turtle configuration interface). This field is just a placeholder.

Overview
To simplify the install process Turtle has been packaged in deb and rpm files and can now be installed on all major GNU/Linux distributions. Please note that at the moment only x86 platform is supported.
It's possible to install Turtle using deb, if you prefer, you can compile it from scratch.

 Compile Turtle from sources

Here you can find the instruction to build Turtle from sources.
Please use this procedure only if the package install doesn't work for you.

Compile Turtle from sources Here you can find the instruction to build Turtle from sources.
Please use this procedure only if the package install doesn't work for you.

Requirements

In order to install the base Turtle system you need a base GNU/Linux x86 system and the following development packages:

Install the Turtle network plugin for giFT

1. turtle-1.0.0 source archive to a temporary directory.
2. Uncompress the archive: gunzip gift-turtle-1.0.0.tar.gz
3. Unpack the archive: tar xvf gift-turtle-1.0.0.tar
4. Go to the gift-turtle-1.0.0 directory and run the configure script:
   cd gift-turtle-1.0.0
   ./configure
5. Build the plugin: make
6. Obtain root privileges in order to install it:
   su
   make install
   exit

.