Переменные окружения#

Все переменные окружения tgs опциональны. Они переопределяют значения, вкомпилированные в бинарник, или значения из конфигурационных файлов.

Переменные#

Variable	Description
`TGS_PROFILE`	Active profile name. Overrides `.tgs.yaml` but is overridden by `--profile` flag.
`TGS_API_ID`	Telegram API ID. Overrides the value compiled into the binary.
`TGS_API_HASH`	Telegram API Hash. Overrides the value compiled into the binary.
`TGS_CONFIG_DIR`	Config directory. Takes precedence over `XDG_CONFIG_HOME`. Default: `$XDG_CONFIG_HOME/tgs`, falling back to `~/.config/tgs`.
`TGS_DATA_DIR`	Data directory for session databases. Takes precedence over `XDG_DATA_HOME`. Default: `$XDG_DATA_HOME/tgs`, falling back to `~/.local/share/tgs`.
`XDG_CONFIG_HOME`	Base config directory (XDG spec). Used as `$XDG_CONFIG_HOME/tgs` when `TGS_CONFIG_DIR` is unset.
`XDG_DATA_HOME`	Base data directory (XDG spec). Used as `$XDG_DATA_HOME/tgs` when `TGS_DATA_DIR` is unset.

Выбор профиля#

# Use the "work" profile for one command
TGS_PROFILE=work tgs whoami

# Use the "work" profile for the whole shell session
export TGS_PROFILE=work

Подробнее см. Порядок определения профиля.

API-ключи#

tgs поставляется с вкомпилированными API-ключами. Большинству пользователей не нужно их менять. Переопределение может понадобиться, если вы собираете tgs из исходников без ключей или хотите использовать свои учётные данные приложения Telegram.

export TGS_API_ID=12345
export TGS_API_HASH=abcdef1234567890abcdef1234567890
tgs login

Получить API-ключи можно на my.telegram.org.

Пользовательские директории#

# Store config in a non-default location
export TGS_CONFIG_DIR=/etc/tgs

# Store sessions on a different volume
export TGS_DATA_DIR=/mnt/secure/tgs-data