1
0
Fork 0
mirror of https://github.com/overleaf/toolkit.git synced 2025-04-19 15:28:06 +02:00

Merge pull request #10 from overleaf/sk-document-persisting-ce-texlive

Add documentation on committing CE image
This commit is contained in:
Shane Kilkelly 2020-09-22 13:50:38 +01:00 committed by GitHub
commit b7eb235be3
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
2 changed files with 33 additions and 0 deletions

View file

@ -39,3 +39,4 @@ documentation on the [Overleaf Wiki](https://github.com/overleaf/overleaf/wiki)
## Upgrades
- [Upgrading the Toolkit](./upgrading.md)
- [Community Edition: Upgrading TexLive](./ce-upgrading-texlive.md)

View file

@ -0,0 +1,32 @@
# Community Edition: Upgrading TexLive
To save bandwidth, the Overleaf image only comes with a minimal install of [TeXLive](https://www.tug.org/texlive/). To upgrade to a complete TeXLive installation, run the installation script in the Overleaf container with the following command:
```bash
$ bin/docker-compose exec sharelatex tlmgr install scheme-full
```
Alternatively you can install packages manually as you need by replacing `scheme-full` with the package name.
Note that these changes made inside the `sharelatex` container with `docker exec` are ephemeral --- they will be lost if Compose recreates the container. To make them persistent, you can use `docker commit` to save the changes to a new docker image:
```bash
$ docker commit sharelatex sharelatex/sharelatex:with-texlive-full
```
Then add a `docker-compose.override.yml` file to the `config/` folder, and specify
that the toolkit should use this new image to launch the `sharelatex` container in future:
```yml
---
services:
sharelatex:
image: sharelatex/sharelatex:with-texlive-full
```
Then run `bin/stop && bin/docker-compose rm -f sharelatex && bin/up`, to recreate the container.
Note that you will need to remove this committed container and repeat these steps when you [upgrade](./upgrading.md).
Server Pro users have the option of using [Sandbox Compiles](./sandboxed-compiles.md), which will automatically pull down a full TexLive image.