> 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/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 en 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-installation till det format som används av Toolkit. Denna process innebär att befintlig konfiguration kopieras in i 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 i stället för `OVERLEAF_`.
{% endhint %}

{% stepper %}
{% step %}

### Klona Toolkit-förvaret

Klona först Toolkit-förvaret 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 image och version

I en typisk `docker-compose.yml` är image och version definierade i komponentbeskrivningen, till exempel:

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

När du använder Toolkit löses image-namnet automatiskt; det enda som krävs är att ange `SERVER_PRO=true` i **config/overleaf.rc** för att välja Server Pro-imagen 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 image-id:t för din lokala `senaste` version, använd sedan release-anteckningarna för 2.x.x, 3.x.x, 4.x.x eller 5.x.x för att mappa image-id:t till versionen.

Om du hämtar imagen från ditt eget interna register kan du åsidosätta imagen 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** fil.
{% endstep %}

{% step %}

### Konfigurera extern åtkomst

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

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

{% step %}

### Migrering av miljövariabler

Du har sannolikt 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 Toolkitens [**config/variables.env**](broken://pages/3c514a33a5ca9acacddfe18903f5384d1393bcee) fil och se till att de har följande format (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** fil.
* Variabler som börjar med `OVERLEAF_MONGO_`, `OVERLEAF_REDIS_` och `REDIS_HOST` variabler 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 man migrerar `nginx`, se [TLS Proxy-dokumentationen](/on-premises/sv/konfiguration/overleaf-toolkit/tls-proxy.md):
{% endstep %}

{% step %}

### Volymer

Ställ in platserna för datavolymer i **config/overleaf.rc**:

#### ShareLaTeX

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

#### MongoDB

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

#### Redis

Ställ in `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 Toolkit-konfigurationsdokumenten 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://overleaf-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.