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

Merge pull request #252 from overleaf/jpa-texlive-docs

Browse source 
docs: use config/version for selecting custom VERSION-with-texlive-full
This commit is contained in:
Jakob Ackermann 2024-05-16 16:06:01 +02:00 • committed by GitHub
commit 5f7f356ae3
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 12 additions and 17 deletions
Download patch file Download diff file Expand all files Collapse all files

29
doc/ce-upgrading-texlive.md
View file

@ -59,25 +59,20 @@ 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 are ephemeral --- they will be lost if Compose recreates the container. To make them persistent, use `docker commit` to save the changes to a new docker image:
The changes you've just made have changed the `sharelatex` container, but they are ephemeral --- they will be lost if 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:
```
$ docker commit sharelatex sharelatex/sharelatex:with-texlive-full
$ cat config/version
5.0.3
#^^^^ --------------- matching version ----------- |
# vvvvv
$ docker commit sharelatex sharelatex/sharelatex:5.0.3-with-texlive-full
$ echo 5.0.3-with-texlive-full > config/version
```
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:
After committing the changes, update the `config/version` accordingly. Then run `bin/up`, to recreate the container.
(Note: the version number in `docker-compose.override.yml` MUST match the version number used by the toolkit scripts (such as `lib/docker-compose.base.yml`))
```yml
---
version: '2.2'
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).
Note that you will need to repeat these steps when you [upgrade](./upgrading.md).