View source for Tahoe-LAFS

'''Tahoe-LAFS (Tahoe Least-Authority Filesystem)''' is a Free and Open cloud storage system. It distributes your data across multiple servers. Even if some of the servers fail or are taken over by an attacker, the entire filesystem continues to function correctly, preserving your privacy and security.

<!--T:135-->
Since Version 1.12.0, Tahoe-LAFS supports I2P natively. There is an I2P port of an older version that KillYourTV wrote, but there are some differences.



= Tahoe-LAFS I2P-Port by KillYourTV = <!--T:144-->

== How to get Tahoe-LAFS for I2P == <!--T:138-->

=== Windows === <!--T:139-->

<!--T:72-->
Download Tahoe from one of these sources:

<!--T:73-->
* Torrent: [http://tracker2.postman.i2p/index.php?view=TorrentDetail&id=28429 v1.10, 2014] (on tracker2.postman.i2p)
* [[iMule]]/[[Nachtblitz]]: <tt>ed2k://|file|tahoe-lafs-1.10.0.win32.exe|10448092|BAEF1F12A810FB9578532A0E018DB526|h=OUCDS65B2IXMFUZ7ZAV3T5DDM3BSC654|th=V4pXMwgSLrPL1iWVebNxwbnzE7Qmc34U|/</tt>
* eepsite: http://echelon.i2p/tahoelafs/backup/
* eepsite: <s>[http://killyourtv.i2p/tahoe-lafs/windows/ http://killyourtv.i2p/tahoe-lafs/windows/]</s> (down since march 2016)

<!--T:74-->
Remember to check signatures if you do not download the software from the official website.

=== Linux === <!--T:140-->

<!--T:141-->
Download Tahoe from one of these sources:

<!--T:136-->
* Torrent: [http://tracker2.postman.i2p/index.php?view=TorrentDetail&id=28428 v1.10.0, 2014] (on tracker2.postman.i2p)
* eepsite: http://k1773r.i2p/tahoe-lafs/   Installation script fixed by k1773r (2016)
* eepsite: http://echelon.i2p/tahoelafs/backup/
* [[iMule]]/[[Nachtblitz]]: ?

<!--T:142-->
Remember to check signatures if you do not download the software from the official website.

== Running a client node == <!--T:70-->

=== Windows === <!--T:71-->

<!--T:75-->
Check if Tahoe is installed correctly by opening Windows Command Line (press Win+R and type cmd) then typing: <tt>tahoe --version</tt>, you should see something like this:

<!--T:76-->
<pre>allmydata-tahoe: 1.10.0
foolscap: 0.6.4
pycryptopp: 0.6.0.1206569328141510525648634803928199668821045408958
zfec: 1.4.22
Twisted: 11.0.0
Nevow: 0.10.0
zope.interface: unknown
python: 2.7.7
platform: Windows-7-6.1.7601-SP1
pyOpenSSL: 0.13.1
simplejson: 3.5.2
pycrypto: 2.4.1
pyasn1: 0.1.7
mock: 1.0.1</pre>

<!--T:89-->
Create a new client by typing in the console: <tt>tahoe create-client</tt>.

<!--T:90-->
Go into C:\Users\&lt;[http://i2pwiki.i2p/YourUserName YourUserName]&gt;\.tahoe catalog, open '''tahoe.cfg''' file in notepad, in section '''node''' enter any nickname, change <tt>http_proxy</tt> to <tt>127.0.0.1:4444</tt>, uncomment <tt>tub.location</tt> otherwise your (at worse external!) IP will be leaked to introducers:

<!--T:91-->
<pre>[node]
nickname = YourRandomNickname
web.port = tcp:3456:interface=127.0.0.1
web.static = public_html
http_proxy = 127.0.0.1:4444
# **IMPORTANT**
# You NEED to configure tub.location when running
# an I2P-enabled Tahoe-LAFS node. Otherwise your IP
# can be leaked to the introducers!
# Read the docs and/or come to #tahoe-lafs on Irc2P for assistence.
#tub.port =
tub.location =
#log_gatherer.furl =
#timeout.keepalive =
#timeout.disconnect =
#ssh.port = 8022
#ssh.authorized_keys_file = ~/.ssh/authorized_keys</pre>

<!--T:107-->
In '''client''' section remove None word in <tt>introducer.furl</tt>, save and exit the file:

<!--T:108-->
<pre>[client]
# Which services should this client connect to?
introducer.furl =
helper.furl =
#key_generator.furl =
#stats_gatherer.furl =</pre>

<!--T:113-->
Create '''introducers''' file (without .txt extension) and paste the list of introducers from [http://killyourtv.i2p/tahoe-lafs/introducers/ http://killyourtv.i2p/tahoe-lafs/introducers/]:

<!--T:114-->
<pre>pb://c6w5ernw7y7rp3uwmdyu5clujyt2y4m4@w2zrwz5gplkkufix7cb4gmxfbrkwg2abnsgk62bm5iifzlahe7kq.b32.i2p/introducer
pb://exupps5kk3amc5iq4q6f5ahggkm4s5fl@oj7cffq5fnk46iw3i3h2sdgncxrqbxm7wh6i4h2cbpmqsydygkcq.b32.i2p/introducer
pb://md2tltfmdjvzptg4mznha5zktaxatpmz@5nrsgknvztikjxnpvidlokquojjlsudf7xlnrnyobj7e7trdmuta.b32.i2p/introducer
pb://fmcbgy7zd6ubrbphilmrlocvb7f327z5@gdr3tt5uewgnm7r7xn54k2qikf2kuwwegjjsnkz44pjticcacsua.b32.i2p/introducer
pb://tq7rx35yopkvodmsxkqra4qqkbho3yaa@6ga2r2h2fyq6tzcyh6bf3hpio3i7r4edadbq7l4wnh4y62taj6ia.b32.i2p/introducer
pb://cys5w43lvx3oi5lbgk6liet6rbguekuo@sagljtwlctcoktizkmyv3nyjsuygty6tpkn5riwxlruh3f2oze2q.b32.i2p/introducer
pb://r3bs6joub24gtsofe7ohnnjcnwfmo2jy@qaihdh5z7osn7tc3326ahv3z46badiuaulff43wchmap7skg7euq.b32.i2p/42mrbm7zxmjemz6hzejo3i7aunx4eoun</pre>

<!--T:120-->
Open Start Tahoe-LAFS shortcut in your start menu, go into Tahoe summary page: [http://127.0.0.1:3456/ http://127.0.0.1:3456/] to check if everything works, you should be connected to about 5 introducers and 18 storage servers.

=== Linux === <!--T:121-->

<!--T:122-->
There is a official documentation :

<!--T:143-->
See: [http://killyourtv.i2p/tahoe-lafs/install/ http://killyourtv.i2p/tahoe-lafs/install/] (backup: http://echelon.i2p/tahoelafs/backup/install.html )

== Uploading a website == <!--T:123-->

<!--T:124-->
Open cmd and type :
<syntaxhighlight lang="bash">tahoe create-alias YOURALIAS </syntaxhighlight> 
to create an alias (not visible to other users).

<!--T:125-->
Upload your website into grid using <tt>tahoe cp</tt> command: 
<syntaxhighlight lang="bash">tahoe cp -r -v "C:\pathtoyourdeepsite" YOURALIAS</syntaxhighlight>
This is very time consuming process, uploading a single 50MB files could be faster than uploading 150 files of 5MB total, so consider for example converting all small images into base64 and embedding them into html file.

<!--T:126-->
After uploading, check if all files are uploaded: <syntaxhighlight lang="bash">tahoe ls YOURALIAS</syntaxhighlight>

<!--T:127-->
Type <syntaxhighlight lang="bash">tahoe list-aliases</syntaxhighlight>, or open C:\Users\"YourUserName"\.tahoe\private\aliases file to get your private keys, and go into website: <tt>http://127.0.0.1:3456/uri/URI:DIR2:&lt;yourprivatekey&gt;</tt>.

<!--T:128-->
Click '''More info on this directory''' and copy your public key from '''Directory readcap''', so your website address is: <tt>http://127.0.0.1:3456/uri/URI:DIR2-RO:&lt;yourpublickey&gt;/index.htm</tt>.

<!--T:129-->
Never share address without URI:DIR2-'''RO''' (read only) otherwise others can vandalize/delete your site!

<!--T:130-->
Older files will be deleted from the network (grid). To prevent this, run the following command from time to time (once per 2 months): <syntaxhighlight lang="bash">tahoe deep-check -v --repair --add-lease YOURALIAS</syntaxhighlight>



= Official Tahoe-LAFS = <!--T:145-->

== Installation == <!--T:146-->

=== pip (Clearnet) === <!--T:147-->

<!--T:148-->
Please note that this downloads from the clearnet. Assuming python 2 and pip is installed, run the following command:

<!--T:149-->
<pre>pip install tahoe-lafs[i2p]</pre>

<!--T:150-->
(Instead of <code>pip</code>, you might need to use either <code>pip2</code>, <code>python -m pip</code> or <code>python2 -m pip</code>.)

<!--T:151-->
If configured correctly, you should be able to run <code>tahoe</code>.

<!--T:175-->
In case of openssl error, try: <code>apt-get install libssl-dev</code> as root

== Creating an node == <!--T:152-->

<!--T:153-->
Be sure that the I2P router is running and the SAM application bridge is activated in the clients settings. You can change the node-directory using the option <code>-C directory</code>. The default directory is <tt>~/.tahoe</tt>. All related files are stored in that folder.

<!--T:154-->
Run one of the following commands:

<!--T:155-->
* Client node: <code>tahoe create-client --hide-ip</code>
* Storage node: <code>tahoe create-node --hide-ip --listen=i2p</code>
* Introducer: <code>tahoe create-introducer --hide-ip --listen=i2p</code>

<!--T:156-->
Then open the node-directory and open <tt>tahoe.cfg</tt> with your favorite text editor. Find <tt>[connections]</tt>, and change the value of <tt>tcp</tt> from <tt>tor</tt> to <tt>disabled</tt> to make an I2P-only node.

<!--T:157-->
I2P support is enabled by default, so you don't need further configuration. See [[#Custom I2P settings]] on how to configure for different I2P settings.

== Running and stopping an node == <!--T:158-->

<!--T:159-->
To start an node, either run:

<!--T:160-->
* in background: <code>tahoe start</code>
* in foreground: <code>tahoe run</code>

<!--T:161-->
To stop an node, either press <tt>CTRL + C</tt> (in foreground-mode) or run <code>tahoe stop</code>. Run <code>tahoe restart</code> to restart the node.

== Configuring multiple introducers == <!--T:162-->

<!--T:163-->
The <tt>introducer.furl</tt>-key in the configuration file <tt>tahoe.cfg</tt> only allows one introducer. To use multiple introducers, create the file <tt>private/introducers.yaml</tt> and open it with your favorite editor. The format is:

<!--T:164-->
<pre>introducers:
    petname2:
      furl: FURL2
    petname3:
      furl: FURL3</pre>

<!--T:165-->
The petnames is just an locally-unique identifier. You can leave <tt>introducer.furl</tt> empty. There's a list of introducers, taken from the introducer list above:

<!--T:166-->
<pre>introducers:
    introducer_by_killyourtv:
      furl: pb://c6w5ernw7y7rp3uwmdyu5clujyt2y4m4@i2p:w2zrwz5gplkkufix7cb4gmxfbrkwg2abnsgk62bm5iifzlahe7kq.b32.i2p/introducer
    introducer_by_str4d:
      furl: pb://exupps5kk3amc5iq4q6f5ahggkm4s5fl@i2p:oj7cffq5fnk46iw3i3h2sdgncxrqbxm7wh6i4h2cbpmqsydygkcq.b32.i2p/introducer
    introducer_by_COMiX:
      furl: pb://md2tltfmdjvzptg4mznha5zktaxatpmz@i2p:5nrsgknvztikjxnpvidlokquojjlsudf7xlnrnyobj7e7trdmuta.b32.i2p/introducer
    introducer_by_Meeh:
      furl: pb://fmcbgy7zd6ubrbphilmrlocvb7f327z5@i2p:gdr3tt5uewgnm7r7xn54k2qikf2kuwwegjjsnkz44pjticcacsua.b32.i2p/introducer
    introducer_by_uddh:
      furl: pb://tq7rx35yopkvodmsxkqra4qqkbho3yaa@i2p:6ga2r2h2fyq6tzcyh6bf3hpio3i7r4edadbq7l4wnh4y62taj6ia.b32.i2p/introducer
    introducer_by_zoidberg:
      furl: pb://cys5w43lvx3oi5lbgk6liet6rbguekuo@i2p:sagljtwlctcoktizkmyv3nyjsuygty6tpkn5riwxlruh3f2oze2q.b32.i2p/introducer
    introducer_by_weldok:
      furl: pb://r3bs6joub24gtsofe7ohnnjcnwfmo2jy@i2p:qaihdh5z7osn7tc3326ahv3z46badiuaulff43wchmap7skg7euq.b32.i2p/42mrbm7zxmjemz6hzejo3i7aunx4eoun
    introducer_N2_by_zoidberg
      furl: pb://s3f75h3w2wo6fhwyhqynr4isz42lcevo@i2p:yv22edrf5y34rqcrn6f2kgfkaw6guq2wlm2wnaxmg4bgyq77htgq.b32.i2p/yvt2fmerjdapxxeqef5eo74zy5w7za73</pre>

== Custom I2P settings == <!--T:167-->

<!--T:168-->
If you're using different I2P settings, tahoe might not be able to find the I2P SAM application port. Use the option <code>--i2p-sam-port=tcp:address:port</code> to specify the SAM application bridge address and port. The default is <tt>tcp:127.0.0.1:7656</tt>.

<!--T:169-->
If you changed the I2P settings after the configuration, you need to edit the configuration file <tt>tahoe.cfg</tt>. Search for the section <tt>[i2p]</tt> or create one.

<!--T:170-->
;enabled
: (default: <tt>true</tt>) Whenever I2P support is enabled
;sam.port
: (default: <tt>tcp:127.0.0.1:7656</tt>) Address and port to the SAM application bridge.
;dest
: Unknown, not described on the official documentation
;dest.port
: Unknown, not described on the official documentation

<!--T:171-->
Example configuration used by <code>tahoe create-node --hide-ip --listen=i2p</code>:

<!--T:172-->
<pre>[i2p]
dest = true
dest.port = 3457
sam.port = tcp:127.0.0.1:7656
dest.private_key_file = private/i2p_dest.privkey</pre>

== Differences with the older I2P-Port == <!--T:173-->

<!--T:174-->
* The introduces addresses for I2P contains an <tt>i2p:</tt> between the <tt>@</tt>-character and the b32-address.
* When using multiple introduces, you'd use <tt>private/introducers.yaml</tt> instead of <tt>introducers</tt>, with an different format.
* The official Tahoe-LAFS uses the SAM application bridge, the I2P-Port uses an explicit HTTP Proxy.


= External Links = <!--T:131-->

<!--T:132-->
* <s>[http://killyourtv.i2p/tahoe-lafs/ http://killyourtv.i2p/tahoe-lafs/] - Official website</s> ([http://inr.i2p/search/?q=killyourtv.i2p last seen in march 2016])

<!--T:133-->
* <s>[http://killyourtv.i2p/tahoe-lafs/exampleurls/ http://killyourtv.i2p/tahoe-lafs/exampleurls/] - Example URLs </s> ([http://inr.i2p/search/?q=killyourtv.i2p last seen in march 2016])

<!--T:134-->
* [http://tahoe.fatsvin.i2p/?i2paddresshelper=tTsclxWuOxZAFDNj~wlShnbqJipcGMyWHV~9OJ9GhjT-Sj-SlufR4DvoStRrynDjE7mJL-2ofyQDY~8T7NLWBPbywY61b6TUuBpEXQ2JTtHjVu44g-VoGKarwXAdAp2IdQK02TXtqn3dbLvyORqRYfgmakqh2sXHS0ySzlU1tMSX0jNuenpDZvqJN9a8UryNqx8AErk1Bs-IvyD85BUy3XfSTE93UO-jkmoQevyOYp4kjSchXkwLh36MN4UkvFn8nZyCA3yaO~rI5AHtWtrvYBblMNw4MFQGLCL5t86uttIzduot98aNMEWJChEAu3mojBjM3u1Y3ctqcnXBCQc9tWjfTgylY45iLw3qMu~ldcGy7MYLx8eEaWjitrDYwFrabhzbla3Ij0KjzcjxR4YicNVcwkS7agQPSYqErad6C~U-ooy~R4Xy3bozYwc1eNJ1WoYsdKcJOAUFW-pgpf25Ih8pkYZ~uFeLENjU2y2J2mCGNti5TubUaQEuj5yuxssNAAAA http://tahoe.fatsvin.i2p] - Tahoe Gateway by fatsvin
[[Category:I2p]]

<!--T:137-->
* http://echelon.i2p/tahoelafs/ - Backup of some files and docs. The latest (2014) package (v1.3.2 that includes Tahoe-LAFS v1.10) is located into http://echelon.i2p/tahoelafs/backup/

https://tahoe-lafs.org/trac/tahoe-lafs/ticket/2875 grid currently broken on i2p ,because of this ticket