tlmgr-repository

Manage TeX Live package repositories

TLDR

List all configured repositories and their tags (if set)

$ tlmgr repository list

List all packages available in a specific repository

$ tlmgr repository list [path|url|tag]

Add a new repository with a specific tag (the tag is not required)

$ sudo tlmgr repository add [path|url] [tag]

Remove a specific repository

$ sudo tlmgr repository remove [path|url|tag]

Set a new list of repositories, overwriting the previous list

$ sudo tlmgr repository set [path|url|tag]#[tag] [path|url|tag]#[tag] [...]

Show the verification status of all configured repositories

$ tlmgr repository status

SYNOPSIS

tlmgr repository action [options]

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.