> For the complete documentation index, see [llms.txt](https://ayakaleaf-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://ayakaleaf-pro.ayaka.space/on-premises/sv/underhall/docker-compose.yml-to-toolkit-migration.md).

# Migrering från docker-compose.yml till Toolkit

Om du för närvarande använder Docker Compose via en `docker-compose.yml` fil kan migrering till Toolkit göra det enklare att driftsätta, uppgradera och underhålla en lokal version av Overleaf.

För att migrera behöver du konvertera din befintliga Docker Compose-konfiguration till formatet som används av Toolkit. Denna process innebär att kopiera befintlig konfiguration till Toolkit.

Den här guiden går igenom varje steg i processen och säkerställer en smidig migrering från Docker Compose till Toolkit.

{% hint style="info" %}
Dessa instruktioner gäller för v4.x och tidigare. Därför använder alla variabler `SHARELATEX_` prefix istället för `OVERLEAF_`.
{% endhint %}

{% stepper %}
{% step %}

### Klona Toolkit-repot

Klona först Toolkit-repot till värddatorn:

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

Kör sedan `bin/init` kommandot för att initiera Toolkit med dess standardkonfiguration.
{% endstep %}

{% step %}

### Ställa in avbildningen och versionen

I en typisk `docker-compose.yml` definieras avbildningen och versionen i komponentbeskrivningen, till exempel:

```yaml
version: '2.2'
services:
    sharelatex:
        restart: always
        # För Server Pro-användare:
        # image: quay.io/sharelatex/sharelatex-pro
        image: sharelatex/sharelatex:3.5.13
```

När du använder Toolkit löses avbildningsnamnet automatiskt; det enda kravet är att ange `SERVER_PRO=true` i **config/overleaf.rc** för att välja Server Pro-avbildningen eller `SERVER_PRO=false` för att använda Community Edition.

Det önskade versionsnumret för Server Pro/Community Edition anges i **config/version** filen. Toolkit kräver ett specifikt versionsnummer som `4.2.3`. Om du använder `senaste`, kan du använda `bin/images` för att hitta avbildnings-ID:t för din lokala `senaste` versionen och sedan använda versionsanteckningarna för 2.x.x, 3.x.x, 4.x.x eller 5.x.x för att matcha avbildnings-ID:t mot versionen.

Om du hämtar avbildningen från ditt eget interna register kan du skriva över den avbildning som Toolkit använder genom att ange `OVERLEAF_IMAGE_NAME`. Du behöver inte ange taggen eftersom Toolkit automatiskt lägger till den baserat på din **config/version** i filen.
{% endstep %}

{% step %}

### Konfigurera extern åtkomst

Som standard lyssnar Overleaf på `127.0.0.1:80`, och tillåter endast trafik från Docker-värddatorn.

För att tillåta extern åtkomst, ange `OVERLEAF_LISTEN_IP` och `OVERLEAF_PORT` i [**config/overleaf.rc**](/on-premises/sv/konfiguration/overleaf-toolkit/environment-variables.md) i filen.
{% endstep %}

{% step %}

### Migrering av miljövariabler

Du har troligen en uppsättning miljövariabler definierade i `sharelatex` tjänsten i din `docker-compose.yml`, till exempel:

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

Kopiera dessa variabler till Toolkits [**config/variables.env**](broken://pages/3c514a33a5ca9acacddfe18903f5384d1393bcee) fil och se till att följande format används (använd `=` i stället för `:`):

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

Undantag / skillnader när du använder Toolkit:

* Variabler som börjar med `SANDBOXED_COMPILES_` och `DOCKER_RUNNER` behövs inte längre. För att aktivera Sandboxed Compiles, ange `SIBLING_CONTAINERS_ENABLED=true` i din **config/overleaf.rc** i filen.
* Variabler som börjar med `OVERLEAF_MONGO_`, `OVERLEAF_REDIS_` och `REDIS_HOST` variabel behövs inte längre. MongoDB och Redis konfigureras nu i **config/overleaf.rc** filen med `MONGO_URL`, `REDIS_HOST` och `REDIS_PORT`.

För avancerade konfigurationsalternativ, se [config/overleaf.rc](/on-premises/sv/konfiguration/overleaf-toolkit/environment-variables.md) dokumentationen.
{% endstep %}

{% step %}

### NGINX-proxy

För instruktioner om hur du `nginx`, se [dokumentationen för TLS-proxy](/on-premises/sv/konfiguration/overleaf-toolkit/tls-proxy.md):
{% endstep %}

{% step %}

### Volymer

Ange platserna för datavolymer i **config/overleaf.rc**:

#### ShareLaTeX

Ange `OVERLEAF_DATA_PATH` till platsen för datavolymen som används av `sharelatex` containern.

#### MongoDB

Ange `MONGO_DATA_PATH` till platsen för datavolymen som används av `mongo` containern.

#### Redis

Ange `REDIS_DATA_PATH` till platsen för datavolymen som används av `redis` containern.
{% endstep %}
{% endstepper %}

För mer information och avancerad konfiguration, se de relevanta konfigurationsdokumenten för Toolkit som länkas ovan.


---

# 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://ayakaleaf-pro.ayaka.space/on-premises/sv/underhall/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.
