Configuration of PyLinkAhead

The behavior of PyLinkAhead is defined via a configuration that is provided using configuration files. PyLinkAhead tries to read from the inifile specified in the environment variable PYLINKAHEADINI or alternatively in ~/.pylinkahead.ini upon import. After that, the ini file pylinkahead.ini in the current working directory will be read additionally, if it exists.

Here, we will look at the most common configuration options. For a full and comprehensive description please check out the example pylinkahead.ini file. You can download this file and use it as a starting point.

Typically, you need to change at least the url and username fields as required. (Ask your LinkAhead administrator or IT crowd if you do not know what to put there, but for the demo instance at https://demo.indiscale.com, username=admin and password=caosdb should work).

Authentication

The default configuration (that your are asked for your password when ever a connection is created can be changed by setting password_method:

  • with password_method=input password (and possibly user) will be queried on demand (default)

  • use the password manager pass by using pass as value, see also the ArchWiki entry. This also requires password_identifier which refers to the identifier within pass for the desired password.

  • install the python package keyring, to use the system keyring/wallet (macOS, GNOME, KDE, Windows). The password will be queried on first usage.

  • with password_method=plain (strongly discouraged)

The following illustrates the recommended options:

[Connection]
username=YOUR_USERNAME

# password using "pass" password manager
#password_method=pass
#password_identifier=...

# using the system keyring/wallet (macOS, GNOME, KDE, Windows)
#password_method=keyring

#discouraged: password in plain text
#password_method=plain
#password=YOUR_PASSWORD

SSL Certificate

In some cases (especially if you are testing LinkAhead) you might need to supply an SSL certificate to allow SSL encryption.

The cacert option sets the path to the ssl certificate for the connection:

[Connection]
cacert=/path/to/caosdb.ca.pem

Further Settings

debug=0 ensures that debug information is not printed to the terminal every time you interact with LinkAhead which makes the experience much less verbose. Set it to 1 or 2 in case you want to help debugging (which I hope will not be necessary for this tutorial) or if you want to learn more about the internals of the protocol.

timeout sets the timeout for requests to the server.

A complete list of options can be found in the pylinkahead.ini file in the examples folder of the source code.