tlmgr-conf
Configure TeX Live Manager settings
TLDR
Show the current TeX Live configuration
Show the current texmf, tlmgr, or updmap configuration
Show only a specific configuration option
Set a specific configuration option
Delete a specific configuration option
Disable the execution of system calls via \write18
Show all additional texmf trees
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)