LinuxCommandLibrary

tlmgr-conf

Configure TeX Live Manager settings

TLDR

Show the current TeX Live configuration

$ tlmgr conf
copy

Show the current texmf, tlmgr, or updmap configuration
$ tlmgr conf [texmf|tlmgr|updmap]
copy

Show only a specific configuration option
$ tlmgr conf [texmf|tlmgr|updmap] [configuration_key]
copy

Set a specific configuration option
$ tlmgr conf [texmf|tlmgr|updmap] [configuration_key] [value]
copy

Delete a specific configuration option
$ tlmgr conf [texmf|tlmgr|updmap] --delete [configuration_key]
copy

Disable the execution of system calls via \write18
$ tlmgr conf texmf [shell_escape] [0]
copy

Show all additional texmf trees
$ tlmgr conf auxtrees show
copy

SYNOPSIS

tlmgr conf [option=value]

PARAMETERS

conf auxtrees
    Add and remove auxiliary TeX trees.

conf backupsdir
    Set the backup directory.

conf compcache
    Enable or disable the compilation cache.

conf ctan
    Set the default CTAN mirror.

conf generatemcn
    Enable or disable the generation of mcn files.

conf infralocation
    Configure infrastructure location.

conf language
    Set the language for tlmgr messages.

conf letter
    Configure email settings for updates.

conf mode
    Set tlmgr's operation mode (system or user).

conf paper
    Set the default paper size.

conf path
    Set environment variables.

conf pkglockdir
    Set package lock directory.

conf postaction
    Execute action after installation/removal.

conf proxy
    Set the proxy server for network connections.

conf recommend
    Configure recommended packages handling.

conf root
    Set the TeX Live root directory.

conf scheme
    Set the scheme.

conf setupreflink
    Configure setup reflinking options.

conf tlpdb
    Configure TeX Live Package DataBase location.

conf updaterepo
    Configure update repository location.

conf texmfcnf
    Configure texmfcnf option.

DESCRIPTION

tlmgr-conf is a part of the TeX Live Manager (tlmgr) suite. It's specifically used to configure tlmgr itself, not TeX Live as a whole. This configuration includes setting the repository location (where tlmgr downloads packages from), adjusting network settings, and modifying other operational parameters.

You can set the repository URL to a local directory, a network mirror, or even a specific TeX Collection Network archive. Network settings are especially useful for computers behind proxies.

Changes made with tlmgr-conf affect the way tlmgr behaves globally for all users of the TeX Live installation. Therefore, administrative privileges are typically required to modify these settings.

CAVEATS

Modifying configurations with tlmgr-conf can significantly impact your TeX Live installation. Incorrect settings may render it unusable. Always back up your configuration files before making changes. Be especially careful when modifying the repository URL, as this determines where tlmgr downloads packages.

EXAMPLES

Setting the repository to a local directory:
tlmgr conf repository file:///path/to/local/repository

Setting a proxy server:
tlmgr conf proxy http://proxy.example.com:8080/

SEE ALSO

tlmgr(1)

Copied to clipboard