TeX Live Repository for Installation Using the TeX Live Package Manager tlmgr

Deutsch: → TeX Live Repository zur Installation über den TeX Live Paketmanager tlmgr

Since 2013 TeX Live has provided the facility to use several package repositories. Doing so, you can also state which package should be installed from which repository. There are two different methods:

The repository structure has been changed from TeX Live 2015 to TeX Live 2016. Therefore we have two different repositories:

Please note, access to these links is possible with `tlmgr` only.

One-time, not persistent installation

Installing a package from a particular repository once is easy. Just use `tlmgr` this way:

`tlmgr install --repository <URL> <package name>`

You have to replace `<URL>` by the URL of the repository and `<package name>` by the name of the TeX Live package to be installed. If the package has already been installed, you have to add option `--reinstall`. If you want to replace, e.g., `koma-script` of TeX Live 2018 by the package of my repository you can use:

`tlmgr install --reinstall --repository https://www.komascript.de/repository/texlive/2018 koma-script`

Note that with the next update the packages of my repository generally will be replaced by the packages from the main TeX Live repository. This is because the main TeX Live repository internally uses much larger revision numbers. Therefore the above way of installation of a package from my repository is only a temporary one. Nevertheless, you can also remove such packages using the graphical user interface of the TeX Live Package Manager that can be started using »`tlmgr gui`«. After removing the package you can reinstall it from the main TeX Live repository.

Please note, if you have a multi-user installation of TeX Live on Windows, you have to start `tlmgr` as administrator (can be done from an administrator terminal). Multi-user installations of TeX Live on Linux often provide package installation only for user root. In this case you can use `sudo` to execute `tlmgr`, e.g.:

`sudo tlmgr install --reinstall --repository https://www.komascript.de/repository/texlive/2018 koma-script`

Nevertheless, TeX Live provides a user mode for multi-user installations. In user mode every user can install private packages. See the user manual for more information. You get it using either »`texdoc tlmgr`« or »`tlmgr help`«. By the way: Sometimes, the user mode can also be used to update packages and install packages if you do not use Vanilla TeX Live but the TeX Live packages of a Linux distribution.

Pinning a repository for a package

You can define a repository to be the one always used for installation and updates of a package. To do so, you first have to add the repository to the known repositories. Then you can pin that repository for a package, e.g., the TeX Live package `koma-script`:

```tlmgr repository add https://www.komascript.de/repository/texlive/2018 KOMA

Users of TeX Live 2013–2015 please replace the `2018` at the URL by `2015`.

After pinning the repository to the package you still have to install it. If the package has already been installed before, you have to force a re-installation:

`tlmgr install --reinstall koma-script`

While running this installation and all future updates of `koma-script`, `tlmgr` should show a line like:

`[1/1, ??:??/??:??] reinstall: koma-script @KOMA [6373k]`

in the output. The `@KOMA` shows you that the package is installed from the `KOMA` repository.

Please note, if you have a multi-user installation of TeX Live on Windows, you have to start `tlmgr` as administrator (can be done from an administrator terminal). Multi-user installations of TeX Live on Linux often provide package installation only for user root. In this case you can use `sudo` to execute `tlmgr`, e.g.:

```sudo tlmgr repository add https://www.komascript.de/repository/texlive/2018 KOMA
sudo tlmgr pinning add KOMA koma-script
sudo tlmgr install --reinstall koma-script```

Nevertheless, TeX Live provides a user mode for multi-user installations. In user mode every user can install private packages. See the user manual for more information. You get it using either »`texdoc tlmgr`« or »`tlmgr help`«. By the way: Sometimes, the user mode can also be used to update packages and install packages if you do not use Vanilla TeX Live but the TeX Live packages of a Linux distribution.

Verified package installation with TeX Live since 2016

Since TeX Live 2016 TeX Live provides verified package repositories. This works only if `gpg` or `gpg2` has been installed.

My repository also has a digital signature. `tlmgr` can only verify the signature if you first install the needed public key. The finger print of the key is:

`654E 0E2F 3E1F 283C BA58  37A1 4B8E DF5B ACB5 A37E`

The public key is:

```-----BEGIN PGP PUBLIC KEY BLOCK-----
Version: GnuPG v2

mQENBFPkjooBCAC56Bj9QXCC8bxycA6yFXn3lBG+uhKmQw5Kc0orL/FoCsvaNh+K
V6AUWeeOIpK4AqYxdeGNpnSDTiMsRljUtTpYuEgwslW+QiL1XviDaTkQsFQybV7n
4ktgX94xEkS0wQJjW0GGvGuTStIMSw9BLR1P1XbA+h24aEXNB95SopBB8UG23FNR
THamE0GnWDT0Q5cm9135pNPuGsc/LwFWyT47p/314LEonKhWVgqB4ZFHnzErP1qX
VGrimR7XYE4SLZO/5d15T8V7lQEP8ItxdoRLE6C5Ba/jQxzHPuqX4s6saNdkYRAJ
fQthp1DtIifIWlpXouLwjL3KzUcmzEmkHZ0tABEBAAG0UEtPTUEucmVwbyAoVGhp
cyBrZXkgaXMgdXNlZCBvbmx5IHRvIHNpZ24gbXkgcmVwb3NpdG9yaWVzLikgPGtv
bWFzY3JpcHRAZ214LmluZm8+iQE/BBMBAgApBQJT5I6KAhsDBQkJZgGABwsJCAcD
AgEGFQgCCQoLBBYCAwECHgECF4AACgkQS47fW6y1o35wnAf/QHZst8o1KmCAQrHI
WcSve0551yAUmCYew611BUp/HOs6nipIencuQZX1h2+NFPQW4nnmykdIWTdAhQEz
bzq/8JF01qm0bhwVKLVQGV7lxLshzJbHYvHFg0UxNCd3SWBODeaJJcGcixJ+BrJi
m0Q1nM1iPYSnZdss38SW8rKxKklYqyVmSeDHuAwvOt0jDvkuiVvaWjG14Gc4XMP4
Ojoxn24AgkFqYjHMljYQDD+58H9R5qh8zzprJ6EzjzsC0nGkPCnHlNrKxC3AO1m1
rwFueAFPFYi7b6XtsrSNUi0erP1R32iLjEPpzD9c3UZ0sHEbw7LC2g7VIwLtJ2Jt
NOvjT7kBDQRT5I6KAQgAzGQjraa+A74W3DemB75sRfpi/Lh+U7T1cIomqUY1jf5T
Fi/3KVIDaaXM+bKgrEzKNZ3vYbqV6HVR25Rl/dDOjM9U/tqnjsZ4iYSacwpTwtmO
2jBryaSB69RlC6r3VrgH5smv5rgc+83ybmBoVYh0gW2sgMvjWV+zUNY8NXjfkpsF
qBinPUz/75524qJOzrDxBUMG3WHQ7ONL0OWF0nLeyqJLT+leAbMT7G+QZQfmJfEw
TIoN2iafnrkh4iTNCHcpqQ/v75T1/BEyXijq34iqT+rz6vCNsKm5+KsVA8gumQ9S
J1yV3fRQeBvLfes4Ige/fASpz8SPev+pJoGSHDZuUQARAQABiQElBBgBAgAPBQJT
5I6KAhsMBQkJZgGAAAoJEEuO31ustaN+7g8H+wYdR1O8FDE/0Tw8akQpZp+oYjhQ
s6s5F4PqIuwL3egGw2UuiQbv1ye9qISven9D5FA7JLDSFApYgVViJ7CB5wz6Liyx
TdX/PEK4Ujxtw1K5R4O1NfMdJp5+nx6MkJQk5FzAe7xsuVINfQS/tYzOyd49bklo
f1t6IjOpDLv02opIilDUHSatz3Zz4OL67a1CYGcJ30CkHDJhPMETCKkt+OpWNZ4x
ZU0OdhbA6j6DkLTCFxBPzDeQumK0L2RNV1B4CXScBo6FoI1MM+piF/3eW7aWMntN
joO/2AE0GUWo7QBlF+5JQAKsB8gEtLxmWfbCL+A+d1+wBOvcdZjAWc5R5PQ=
=looA
-----END PGP PUBLIC KEY BLOCK-----```

But do not add the key to your usual keyring. You should add it to the keyring of TeX Live using `tlmgr`. To do so, you should first save the key as file `KOMA.repo.asc` and then call:

`tlmgr key add KOMA.repo.asc`

You can list the keys using:

`tlmgr key list`

For TeX Live 2018 it should result in:

```/usr/local/texlive/2018/tlpkg/gpg/pubring.gpg
---------------------------------------------
pub   rsa2048 2016-03-19 [SC]
C78B82D8C79512F79CC0D7C80D5E5D9106BAB6BC
uid        [ ultimativ ] TeX Live Distribution <tex-live@tug.org>
sub   rsa2048 2016-03-19 [E]
sub   rsa2048 2016-03-19 [S] [verfällt: 2018-09-06]

/usr/local/texlive/2018/tlpkg/gpg/repository-keys.gpg
-----------------------------------------------------
pub   rsa2048 2014-08-08 [SC] [verfällt: 2019-08-07]
654E0E2F3E1F283CBA5837A14B8EDF5BACB5A37E
uid        [ unbekannt ] KOMA.repo (This key is used only to sign my repositories.) <komascript@gmx.info>
sub   rsa2048 2014-08-08 [E] [verfällt: 2019-08-07]```

The file paths and the expire dates may differ. For TeX Live 2016 and 2017 also only the last eight digits of the fingerprints are shown.

Please note, if you have a multi-user installation of TeX Live on Windows, you have to start `tlmgr` as administrator (can be done from an administrator terminal). Multi-user installations of TeX Live on Linux often provide key management only for user root. In this case you can use `sudo` to execute `tlmgr`, e.g.:

`sudo tlmgr key add KOMA.repo.asc`

As far as I know, key management in user mode is currently not supported by `tlmgr`.

Nevertheless, you can use TeX Live since 2016 without repository verification. See the manual for more information. You get it using either »`texdoc tlmgr`« or »`tlmgr help`«.

1—For compatibility https://www.komascript.de/repository/texlive/2016 and https://www.komascript.de/repository/texlive/2017 still work but it is recommended to not use them any longer.