Old Configuration Files

Tahoe-LAFS releases before v1.3.0 had no tahoe.cfg file, and used distinct files for each item listed below. If Tahoe-LAFS v1.9.0 or above detects the old configuration files at start up it emits a warning and aborts the start up. (This was issue ticket #1385.)

Config setting

File

Comment

[node]nickname

BASEDIR/nickname

[node]web.port

BASEDIR/webport

[node]tub.port

BASEDIR/client.port

(for Clients, not Introducers)

[node]tub.port

BASEDIR/introducer.port

(for Introducers, not Clients) (note that, unlike other keys, tahoe.cfg overrode this file from Tahoe-LAFS v1.3.0 up to and including Tahoe-LAFS v1.8.2)

[node]tub.location

BASEDIR/advertised_ip_addresses

[node]log_gatherer.furl

BASEDIR/log_gatherer.furl

(one per line)

[node]timeout.keepalive

BASEDIR/keepalive_timeout

[node]timeout.disconnect

BASEDIR/disconnect_timeout BASEDIR/introducer.furl

BASEDIR/private/introducers.yaml

[client]helper.furl

BASEDIR/helper.furl

[client]key_generator.furl

BASEDIR/key_generator.furl BASEDIR/stats_gatherer.furl

Stats gatherer has been removed.

[storage]enabled

BASEDIR/no_storage

(False if no_storage exists)

[storage]readonly

BASEDIR/readonly_storage

(True if readonly_storage exists)

[storage]sizelimit

BASEDIR/sizelimit

[storage]debug_discard

BASEDIR/debug_discard_storage

[helper]enabled

BASEDIR/run_helper

(True if run_helper exists)

Note: the functionality of [node]ssh.port and [node]ssh.authorized_keys_file were previously (before Tahoe-LAFS v1.3.0) combined, controlled by the presence of a BASEDIR/authorized_keys.SSHPORT file, in which the suffix of the filename indicated which port the ssh server should listen on, and the contents of the file provided the ssh public keys to accept. Support for these files has been removed completely. To ssh into your Tahoe-LAFS node, add [node]ssh.port and [node].ssh_authorized_keys_file statements to your tahoe.cfg.

Likewise, the functionality of [node]tub.location is a variant of the now (since Tahoe-LAFS v1.3.0) unsupported BASEDIR/advertised_ip_addresses . The old file was additive (the addresses specified in advertised_ip_addresses were used in addition to any that were automatically discovered), whereas the new tahoe.cfg directive is not (tub.location is used verbatim).

The stats gatherer has been broken at least since Tahoe-LAFS v1.13.0. The (broken) functionality of [client]stats_gatherer.furl (which was previously in BASEDIR/stats_gatherer.furl), is scheduled to be completely removed after Tahoe-LAFS v1.15.0. After that point, if your configuration contains a [client]stats_gatherer.furl, your node will refuse to start.