Overleaf docs
Plans and pricingTemplatesUser docsGo to Overleaf
On-premises
On-premises
  • Welcome
    • Server Pro vs. Community Edition
  • Release notes
    • Release notes 5.x.x
      • Doc version recovery
    • Release notes 4.x.x
    • Release notes 3.x.x
      • Full project history migration
    • Release notes 2.x.x
    • Release notes 1.x.x
    • Release notes 0.x.x
  • Getting started
    • Before you start
    • Requirements
      • Skills needed
      • Hardware requirements
      • Software requirements
    • Microservices
    • Server Pro infrastructure
    • What is the Overleaf Toolkit?
  • Installation
    • Introduction
    • Using the Toolkit
      • 1: Download the Toolkit
      • 2: Familiarize yourself with the Toolkit
      • 3: Initialize the configuration
      • 4. Choose Community Edition or Server Pro
      • 5. Personalizing your instance
      • 6. Post-installation tasks
    • Air-gapped/offline deployments
    • Upgrading TeX Live
  • Configuration
    • Overleaf Toolkit
      • Files and locations
      • Toolkit settings
      • Environment variables
      • Server Pro-only configuration
        • LDAP
        • SAML 2.0
        • Sandboxed Compiles
        • Git integration
        • Templates
        • Adding LaTeX user help
      • Logging
      • TLS proxy
      • Branding
      • Localization
      • Email delivery
      • Redis
      • S3
  • Maintenance
    • docker-compose.yml to Toolkit migration
    • Upgrading your deployment
    • Data and backups
      • Exporting projects
    • Extending TeX Live
    • Horizontal scaling
    • S3 migration
    • Updating MongoDB
  • User and project management
    • User management
      • Username migration
    • Understanding license usage
    • Project management
  • Support
    • Project limits
    • Troubleshooting
    • Getting help
    • Support guides
      • Using templates as an individual
    • Overleaf user docs
Powered by GitBook
LogoLogo

Discover Overleaf

  • Home
  • Features

Solutions

  • Plans and pricing
  • For universities
  • For business
  • For government

Resources

  • Templates
  • User docs and LaTeX learning
  • Blog

© Overleaf

On this page
  • Getting inside the sharelatex container
  • Determining your current TeX Live version
  • Installing packages
  • Saving your changes

Was this helpful?

Export as PDF
  1. Installation

Upgrading TeX Live

PreviousAir-gapped/offline deploymentsNextOverleaf Toolkit

Last updated 5 months ago

Was this helpful?

To save bandwidth, both the Overleaf Community Edition and Server Pro images only come with a minimal install of . You can install more packages or upgrade to a complete TeX Live installation using the command in the sharelatex container.

The following instructions only apply to Community Edition installations. We highly recommend that Server Pro users enable as this provides users with access to the same TeX Live images used on as well as providing isolation between project compiles for enhanced security.

Getting inside the sharelatex container

To start a shell inside the sharelatex container, run

bin/shell

You will get a prompt that looks like:

root@309b192d4030:/#

In the following instructions, we will assume that you are in the container.

Determining your current TeX Live version

TeX Live is released every year around the month of April. Steps for using tlmgr are different depending on whether you are using the current release or an older one. You can check which version of TeX Live you are running with tlmgr --version. For example, this installation runs TeX Live 2021:

# tlmgr --version
tlmgr revision 59291 (2021-05-21 05:14:40 +0200)
tlmgr using installation: /usr/local/texlive/2021
TeX Live (https://tug.org/texlive) version 2021

The current release of TeX Live can be found on .

If you are running an older TeX Live version, you have two options. A new version of the Overleaf Docker image is usually released shortly after a TeX Live release, you can either wait for it and upgrade your deployment using bin/upgrade script, or, if you prefer to keep the older TeX Live release, you will first need to tell tlmgr to use a historic repository. You will find instructions for doing so .

Installing packages

To install a complete TeX Live installation, run this command inside the sharelatex container:

tlmgr install scheme-full

You can also install individual packages manually:

tlmgr install tikzlings tikzmarmots tikzducks

From 3.3.0 release onwards running tlmgr path add is required again after every use of tlmgr install, in order to correctly symlink all the binaries into the system path.

Many more commands are available. Find out more with:

tlmgr help

When you're done, type exit or press Control-D to exit the shell.

Saving your changes

The changes you've just made have changed the sharelatex container, but they are ephemeral -- they will be lost if Docker Compose recreates the container, e.g. as part of updating the config.

To make them persistent, use docker commit to save the changes to a new docker image:

cat config/version #5.2.1
docker commit sharelatex sharelatex/sharelatex:5.2.1-with-texlive-full
echo 5.2.1-with-texlive-full > config/version

After committing the changes, update the config/version accordingly. Then run bin/up, to recreate the sharelatex container.

You will need to repeat these steps each time you to a new Overleaf version.

TeX Live
tlmgr
Sandboxed Compiles
overleaf.com
the TeX Live homepage
here
upgrade