> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/on-premises/on-premises-no/vedlikehold/docker-compose.yml-to-toolkit-migration.md).

# Migrering fra docker-compose.yml til Toolkit

Hvis du for øyeblikket bruker Docker Compose via en `docker-compose.yml` fil, kan migrering til Toolkit gjøre det enklere å distribuere, oppgradere og vedlikeholde en lokal versjon av Overleaf.

For å migrere må du konvertere den eksisterende Docker Compose-oppsetningen din til formatet som brukes av Toolkit. Denne prosessen innebærer å kopiere eksisterende konfigurasjon inn i Toolkit.

Denne veiledningen vil lede deg gjennom hvert trinn i denne prosessen og sikre en smidig migrering fra Docker Compose til Toolkit.

{% hint style="info" %}
Disse instruksjonene gjelder for v4.x og tidligere. Derfor bruker alle variabler `SHARELATEX_` prefiks i stedet for `OVERLEAF_`.
{% endhint %}

{% stepper %}
{% step %}

### Klon Toolkit-repositoriet

Først kloner du Toolkit-repositoriet til vertsdatamaskinen:

```bash
git clone https://github.com/overleaf/toolkit.git ./overleaf-toolkit
```

Deretter kjører du `bin/init` kommandoen for å initialisere Toolkit med standardkonfigurasjonen.
{% endstep %}

{% step %}

### Angi bilde og versjon

I en typisk `docker-compose.yml` er bilde og versjon definert i komponentbeskrivelsen, for eksempel:

```yaml
version: '2.2'
tjenester:
    sharelatex:
        restart: always
        # Server Pro-brukere:
        # image: quay.io/sharelatex/sharelatex-pro
        image: sharelatex/sharelatex:3.5.13
```

Når du bruker Toolkit, blir image-navnet automatisk løst opp; det eneste kravet er å sette `SERVER_PRO=true` i **config/overleaf.rc** for å velge Server Pro-imaget eller `SERVER_PRO=false` for å bruke Community Edition.

Det ønskede versjonsnummeret for Server Pro/Community Edition settes i **config/version** filen. Toolkit krever et bestemt versjonsnummer som `4.2.3`. Hvis du bruker `latest`, kan du bruke `bin/images` for å finne image-ID-en til din lokale `latest` versjon, og bruk deretter utgivelsesnotatene for 2.x.x, 3.x.x, 4.x.x eller 5.x.x til å mappe image-ID-en til versjonen.

Hvis du henter imaget fra ditt eget interne register, kan du overstyre imaget Toolkit bruker ved å sette `OVERLEAF_IMAGE_NAME`. Du trenger ikke å spesifisere taggen, siden Toolkit automatisk vil legge den til basert på din **config/version** filen.
{% endstep %}

{% step %}

### Konfigurere ekstern tilgang

Som standard vil Overleaf lytte på `127.0.0.1:80`, og bare tillate trafikk fra Docker-vertsmaskinen.

For å tillate ekstern tilgang, sett `OVERLEAF_LISTEN_IP` og `OVERLEAF_PORT` i [**config/overleaf.rc**](/on-premises/on-premises-no/konfigurasjon/overleaf-toolkit/environment-variables.md) filen.
{% endstep %}

{% step %}

### Migrering av miljøvariabler

Du har sannsynligvis et sett med miljøvariabler definert i `sharelatex` tjenesten i din `docker-compose.yml`, for eksempel:

```yaml
environment:
    OVERLEAF_APP_NAME: Overleaf Community Edition
    OVERLEAF_PROXY_LEARN: 'true'
    …
```

Kopier disse variablene inn i Toolkit sin [**config/variables.env**](broken://pages/c0ffc56ce41ad234a342dad5f6b8b7a1aef2e1df) fil, og sørg for følgende form (bruk `=` i stedet for `:`):

```env
OVERLEAF_APP_NAME=Overleaf Community Edition
OVERLEAF_PROXY_LEARN=true
```

Unntak / forskjeller når du bruker Toolkit:

* Variabler som begynner med `SANDBOXED_COMPILES_` og `DOCKER_RUNNER` er ikke lenger nødvendige. For å aktivere Sandboxed Compiles, sett `SIBLING_CONTAINERS_ENABLED=true` i **config/overleaf.rc** filen.
* Variabler som begynner med `OVERLEAF_MONGO_`, `OVERLEAF_REDIS_` og `REDIS_HOST` variablene er ikke lenger nødvendige. MongoDB og Redis konfigureres nå i **config/overleaf.rc** filen ved å bruke `MONGO_URL`, `REDIS_HOST` og `REDIS_PORT`.

For avanserte konfigurasjonsalternativer, se [config/overleaf.rc](/on-premises/on-premises-no/konfigurasjon/overleaf-toolkit/environment-variables.md) dokumentasjonen.
{% endstep %}

{% step %}

### NGINX-proxy

For instruksjoner om hvordan du migrerer `nginx`, se [TLS Proxy-dokumentasjonen](/on-premises/on-premises-no/konfigurasjon/overleaf-toolkit/tls-proxy.md):
{% endstep %}

{% step %}

### Volumer

Angi plasseringene til datavolumene i **config/overleaf.rc**:

#### ShareLaTeX

Sett `OVERLEAF_DATA_PATH` til plasseringen av datavolumet som brukes av `sharelatex` beholderen.

#### MongoDB

Sett `MONGO_DATA_PATH` til plasseringen av datavolumet som brukes av `mongo` beholderen.

#### Redis

Sett `REDIS_DATA_PATH` til plasseringen av datavolumet som brukes av `redis` beholderen.
{% endstep %}
{% endstepper %}

For mer informasjon og avansert konfigurasjon, se den relevante Toolkit-konfigurasjonsdokumentasjonen som er lenket til ovenfor.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://overleaf-pro.ayaka.space/on-premises/on-premises-no/vedlikehold/docker-compose.yml-to-toolkit-migration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
