Frequently asked questions and bug reports

1. Proxy

1.1 How do I know I am using a proxy?

On Windows, you can check if you are using a proxy server to access the Internet by going to Start > Settings > Network & Internet > Proxy (Windows 10). If the slider under Use a proxy server is "off", no proxy is being used.

If you are told that you need to set a proxy, input the Address and Port details and click Save. When in doubt, please consult your IT department.

On Mac OS the proxy information is located under the System Preferences > Network > Advanced > Proxies tab of the network interface, usually Ethernet or Wi-Fi.

1.2 How do I run sett behind a proxy?

In order to run sett behind a proxy, the shell environment variable ALL_PROXY or HTTPS_PROXY must be set. This is the recommended and global way to specify a proxy. Note that, while certain programs support a proxy option (e.g. pip with --proxy), there is currently no such option in sett.

Example:

ALL_PROXY=https://host.domain:port sett-gui

2. Logging

2.1 Does sett generate logs?

Yes, it does. sett logs are stored in the following locations:

  • Linux: ${XDG_DATA_HOME}/ch.biomedit.sett/log or $HOME/.local/share/ch.biomedit.sett/log
  • macOS: $HOME/Library/Application Support/ch.biomedit.sett/log
  • Windows: {FOLDERID_RoamingAppData}\ch.biomedit.sett\log

Log files are rotated daily and named according to the following format: <date>.<app>.jsonl. For example, 2024-08-29.sett-gui.jsonl and 2024-08-29.sett.jsonl for GUI and CLI applications respectively.

Each line within the log file is a JSON object corresponding to a single logging event.

Bug reports

To report a problem with sett or if you have a question not covered in the present documentation please open an issue on our public gitlab repo https://gitlab.com/biomedit/sett-rs/-/issues