> 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/kom-igang/what-is-the-overleaf-toolkit.md). # Vad är Overleaf Toolkit? Overleaf Toolkit är den rekommenderade distributionsmetoden för lokala installationer av Community Edition, Server Pro eller Overleaf Pro; det har utformats för att fungera i den vanligaste miljön: en enda fysisk server eller virtuell maskin. Toolkit använder `docker compose` för att hantera serverns Docker-containrar och tillhandahåller ett antal skript som omsluter `docker` kommandon för att underlätta den mer tekniska delen av att hantera en lokal version av Overleaf. #### Verktyget `bin/docker-compose` wrapper Verktyget `bin/docker-compose` skriptet är en wrapper runt `docker compose`. Det läser in konfiguration från `config/` katalogen, innan det anropar `docker compose` med de argument som skickades till skriptet. Du kan betrakta `bin/docker-compose` som en transparent wrapper för `docker compose` programmet som är installerat på din maskin. Exempel: {% code title="Kontrollera körande containrar" %} ```bash $ bin/docker-compose ps ``` {% endcode %} #### Praktiska hjälpfunktioner Förutom `bin/docker-compose`, tillhandahåller Toolkit praktiska skript för att hjälpa till med vanliga uppgifter: * `bin/up`: genväg till `bin/docker-compose up` * `bin/start`: genväg till `bin/docker-compose start` * `bin/stop`: genväg till `bin/docker-compose stop` * `bin/shell`: startar ett skal inne i **sharelatex** containern * `bin/doctor`: skript som används för att samla in installations- och driftsättningsinformation. Se avsnittet "Kontrollera din server" nedan * `bin/mongo`: startar ett skal inne i **mongo** containern och växlar till rätt databas (**sharelatex**) * `bin/backup-config`: skapa en kopia (zip eller tar) av din aktuella konfiguration och lagra den i en målkatalog som du väljer * `bin/logs`: visa/följa tjänstloggar * `bin/error-logs`: visa/följa tjänsternas felloggar * `bin/rename-env-vars-5-0`: migreringsskript för att uppdatera miljövariabler i **config/variables.env** (omprofilering från ShareLaTeX till Overleaf) * `bin/rename-rc-vars`: migreringsskript för att uppdatera miljövariabler i **config/overleaf.rc** (omprofilering från ShareLaTeX till Overleaf) * `bin/run-script`: hjälpfunktion för att förenkla körning av skript lagrade i **sharelatex** containern * `bin/upgrade`: hjälper till med uppgraderingar av instansen. Skriptet kommer att kontrollera om det finns uppdateringar av Toolkit (via git) och erbjuda att hämta ändringarna, kontrollera den senaste Docker-avbildningsversionen och erbjuda att uppdatera den. Det ger steg-för-steg-bekräftelse, möjlighet att säkerhetskopiera aktuell konfiguration och hanterar att stoppa/starta Docker-tjänster. Se Uppgradering av din driftsättning för mer information: {% hint style="info" %} Om du föredrar att köra din instans utan att ansluta till Docker-loggarna kan du köra `bin/up -d` för att köra i frikopplat läge. {% endhint %} #### Kontrollera din server Overleaf Toolkit innehåller ett praktiskt skript kallat `bin/doctor` som genererar en rapport som pekar ut alla ouppfyllda beroenden. Innan du fortsätter, kör `bin/doctor` skriptet och kontrollera att allt fungerar korrekt: {% code title="Kör Overleaf Doctor" %} ```bash bin/doctor ``` {% endcode %} Exempelutdata (förkortad/illustrativ):
Exempelutdata från bin/doctor ``` ====== Overleaf Doctor ====== - Värdinformation - Linux - Utdata från 'lsb_release -a': Inga LSB-moduler är tillgängliga. Distributörs-ID: Ubuntu Beskrivning: Ubuntu 22.04.5 LTS Utgåva: 22.04 Kodnamn: jammy - Beroenden - bash - status: finns - versionsinfo: 5.1.16(1)-release - docker - status: finns - versionsinfo: Docker-version 27.3.1, build ce12230 - realpath - status: finns - versionsinfo: realpath (GNU coreutils) 8.32 - perl - status: finns - versionsinfo: 5.034000 - awk - status: finns - versionsinfo: GNU Awk 5.1.0, API: 3.0 (GNU MPFR 4.1.0, GNU MP 6.2.1) - openssl - status: finns - versionsinfo: OpenSSL 3.0.2 15 mar 2022 (Bibliotek: OpenSSL 3.0.2 15 mar 2022) - docker compose - status: finns - versionsinfo: Docker Compose-version v2.29.7 - Docker-demon - status: igång ====== Konfiguration ====== - config/version - status: finns - version: 5.1.1 - config/overleaf.rc - status: finns - värden - OVERLEAF_DATA_PATH: data/overleaf - OVERLEAF_LOG_PATH: data/overleaf/logs - SERVER_PRO: true - inloggad på quay.io: true - SIBLING_CONTAINERS_ENABLED: true - OVERLEAF_LISTEN_IP: 0.0.0.0 - OVERLEAF_PORT: 80 - MONGO_ENABLED: true - MONGO_IMAGE: mongo - MONGO_VERSION: 6.0 - MONGO_DATA_PATH: data/mongo - REDIS_ENABLED: true - REDIS_IMAGE: redis:6.2 - REDIS_DATA_PATH: data/redis - config/variables.env - status: finns - värden - OVERLEAF_FILESTORE_BACKEND: fs - OVERLEAF_HISTORY_BACKEND: fs ====== Varningar ====== - Inga, allt är bra ====== Slut ====== ```
Om några beroenden saknas kommer doctor att skriva ut varningar. Om du stöter på problem, kör först `bin/doctor` och kontrollera att utdata innehåller varningar. {% hint style="info" %} * Användare av den kostnadsfria Community Edition bör öppna ett ärende på GitHub: * Användare av Server Pro bör kontakta supporten: mailto: I båda fallen ska du inkludera utdata från `bin/doctor` i ditt meddelande. {% endhint %} --- # 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/kom-igang/what-is-the-overleaf-toolkit.md?ask=&goal= ``` `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.