tlmgr-repository
Manage TeX Live package repositories
TLDR
List all configured repositories and their tags (if set)
List all packages available in a specific repository
Add a new repository with a specific tag (the tag is not required)
Remove a specific repository
Set a new list of repositories, overwriting the previous list
Show the verification status of all configured repositories
SYNOPSIS
tlmgr repository action [options]
PARAMETERS
add repository
Adds a new repository to the list of available sources. The repository can be a URL or a local directory.
remove repository
Removes a specified repository from the list.
set repository
Sets a new or existing repository as current or changes the settings.
list
Lists the currently configured repositories.
-verbose
Provides more detailed output during the operation.
-location repository
Specifies a repository location (URL or file path).
-verify-tls
Enable TLS certificate verification (HTTPS only).
-no-verify-tls
Disable TLS certificate verification (HTTPS only). Use with caution.
DESCRIPTION
The tlmgr repository command is part of the TeX Live package manager (tlmgr). It allows you to manage the repositories from which TeX Live packages are installed and updated. This command enables you to configure the source from which TeX Live retrieves its data and packages. You can add, remove, or modify repository locations.
This is essential for switching to a different mirror, a local repository, or a network share containing TeX Live packages. Properly configured repositories ensure that you receive the latest updates and packages for your TeX system. The command allows you to specify repositories using URLs, file paths, or by referencing a known mirror. Furthermore, it enables you to list the currently configured repositories and their status, including whether they are active or disabled. It is fundamental for controlling the flow of information in your TeX distribution.
CAVEATS
Incorrectly configured repositories can prevent TeX Live from updating or installing packages. Ensure the repository URL or path is valid and accessible. Disabling TLS verification introduces a security risk.
REPOSITORY TYPES
TeX Live repositories can be local directories, network shares, or URLs pointing to CTAN mirrors or custom repositories. Selecting the right repository is crucial for obtaining the correct TeX Live version and updates.
MIRROR SELECTION
Using a mirror that is geographically close to you can improve download speeds. The tlmgr command, together with the repository command, can be employed to select the closest CTAN mirror.
HISTORY
The tlmgr repository command has evolved alongside the TeX Live distribution, becoming more robust and user-friendly over time. Early versions relied more heavily on manual configuration files, whereas modern versions provide a command-line interface for managing repositories directly. The command has adapted to support different repository types, including local directories, HTTP/FTP servers, and mirrors.