# Installera på macOS

## Hårdvarukrav

Weblate bör fungera utan problem på all modern hårdvara. Nedan anges den minimikonfiguration som krävs för att köra Weblate på en enda värd (Weblate, databas och webbserver):

* 3 GB RAM-minne
* 2 CPU-kärnor
* 1 GB lagringsutrymme

#### NOTE
De faktiska kraven för din installation av Weblate varierar kraftigt beroende på storleken på de översättningar som hanteras i den.

### Använt minne

Ju mer minne desto bättre – det används för caching på alla nivåer (filsystem, databas och Weblate). För hundratals översättningskomponenter rekommenderas minst 4 GB RAM-minne.

#### HINT
För system med mindre minne än rekommenderat rekommenderas [Enkelprocess-konfiguration av Celery](https://docs.weblate.org/sv/latest/admin/install.md#minimal-celery).

### CPU-användning

Många samtidiga användare ökar behovet av CPU-kärnor.

Weblate 2026.8 introduced NumPy as a required dependency. On x86-64 systems,
the optimized NumPy build bundled in the Docker image requires an x86-64-v2
compatible CPU. Without the required CPU features, NumPy fails to load and
Weblate cannot start.

Before upgrading, check for the required SSE4.2 CPU feature on the Linux system
running Docker:

```sh
grep sse4_2 /proc/cpuinfo
```

Empty output indicates that a required CPU feature is unavailable. This is a
preliminary check; finding SSE4.2 does not verify all x86-64-v2 CPU features.

If Docker runs in a virtual machine, run the check inside the guest. Virtual
machines can hide CPU features supported by the host. Configure the virtual
machine to expose the required host CPU features, then reboot the guest. If
the physical CPU lacks the required features, upgrade the hardware.

### Lagringsutnyttjande

Den typiska databaslagringsanvändningen är cirka 300 MB per 1 miljon lagrade ord.

Lagringsutrymmet som behövs för klonade arkiv varierar, men Weblate försöker hålla storleken minimal genom att göra ytliga kloner.

### Storage performance

Version control operations perform many filesystem metadata lookups. The
`vcs` subdirectory in [`DATA_DIR`](https://docs.weblate.org/sv/latest/admin/config.md#std-setting-DATA_DIR) therefore needs low read
latency; storage with slow metadata access can make operations such as
**git status** take a long time even when its bulk throughput is good.
Keep [`CACHE_DIR`](https://docs.weblate.org/sv/latest/admin/config.md#std-setting-CACHE_DIR) on low-latency local or temporary storage when
possible.

The deployment checks measure metadata lookup latency for both locations and
warn when the median latency exceeds 10 milliseconds. This is an approximate
point-in-time measurement affected by filesystem and system load. Rerun
**weblate check --deploy** before changing the storage configuration.

### Noder

För små och medelstora webbplatser (miljoner värdord) kan alla Weblate-komponenter (se [Arkitekturöversikt](https://docs.weblate.org/sv/latest/admin/install.md#architecture)) köras på en enda nod.

När du växer till hundratals miljoner lagrade ord rekommenderas det att ha en dedikerad nod för databasen (se [Databasinställningar för Weblate](https://docs.weblate.org/sv/latest/admin/install.md#database-setup)).

## Installation

### Systemkrav

Installera de beroenden som behövs för att bygga Python-modulerna (se [Programvarukrav](https://docs.weblate.org/sv/latest/admin/install.md#requirements)):

```sh
# Use Python 3.14 until all dependencies support Python 3.15.
brew install python@3.14 libyaml pkgconf zstd lz4 xxhash libxmlsec1 uv
export UV_PYTHON="$(brew --prefix python@3.14)/bin/python3.14"
```

Installera valfritt programvara för att köra produktionsservern, se [Körande server](https://docs.weblate.org/sv/latest/admin/install.md#server), [Databasinställningar för Weblate](https://docs.weblate.org/sv/latest/admin/install.md#database-setup), [Bakgrundsuppgifter med Celery](https://docs.weblate.org/sv/latest/admin/install.md#celery). Beroende på storleken på din installation kanske du vill köra dessa komponenter på dedikerade servrar.

Lokala installationsanvisningar:

```sh
# Web server option 1: NGINX and uWSGI
brew install nginx uwsgi

# Web server option 2: Apache with ``mod_wsgi``
brew install httpd

# Caching backend: Valkey
brew install valkey

# Database server: PostgreSQL
brew install postgresql

# Gettext tools for gettext POT/PO update add-ons
brew install gettext
```

### Python-moduler

#### HINT
We’re installing Weblate in a separate Python environment.

1. Create the Python environment for Weblate:
   ```sh
   uv venv ~/weblate-env
   ```
2. Activate the Python environment for Weblate:
   ```sh
   . ~/weblate-env/bin/activate
   ```
3. Installera Weblate inklusive alla valfria beroenden:
   ```sh
   # Install Weblate with all optional dependencies
   uv pip install "weblate[all]"
   ```

   Se [Python-beroenden](https://docs.weblate.org/sv/latest/admin/install.md#python-deps) för finjustering av valfria beroenden.

#### SEE ALSO
* [Använda Python-miljöer](https://docs.astral.sh/uv/pip/environments/)
* [Felsökning av pip-installation](https://docs.weblate.org/sv/latest/admin/install.md#troubleshoot-pip-install)

### Konfigurera Weblate

#### NOTE
The following assumes the Python environment used by Weblate is activated
(by executing `. ~/weblate-env/bin/activate`). If not, specify the full path
to the **weblate** command as `~/weblate-env/bin/weblate`.

1. Kopiera filen `~/weblate-env/lib/python3.9/site-packages/weblate/settings_example.py` till `~/weblate-env/lib/python3.9/site-packages/weblate/settings.py`.
2. Justera värdena i den nya filen `settings.py` efter eget tycke. Du måste ange åtminstone databasens inloggningsuppgifter och Djangos hemliga nyckel, men du kommer att behöva göra fler ändringar för produktionskonfigurationen, se [Justera konfigurationen](https://docs.weblate.org/sv/latest/admin/install.md#configuration).
3. Skapa databasen och dess struktur för Weblate (exempelinställningarna använder PostgreSQL, se [Databasinställningar för Weblate](https://docs.weblate.org/sv/latest/admin/install.md#database-setup) för en produktionsklar installation):
   ```sh
   weblate migrate
   ```

   #### SEE ALSO
   [`migrate`](https://docs.weblate.org/sv/latest/admin/management.md#weblate-admin-migrate)
4. Skapa ett administratörskonto med namnet `admin`, generera ett lösenord och kopiera det till urklipp. Kom ihåg att spara det för senare användning:
   ```sh
   weblate createadmin
   ```

   #### HINT
   Om du tidigare har tappat bort/glömt administratörslösenordet kan du skapa ett nytt med följande kommando:
   ```sh
   weblate createadmin --update
   ```

   #### SEE ALSO
   [`createadmin`](https://docs.weblate.org/sv/latest/admin/management.md#weblate-admin-createadmin)
5. Samla in de statiska filerna för din webbserver (se [Körande server](https://docs.weblate.org/sv/latest/admin/install.md#server) och [Servering av statiska filer](https://docs.weblate.org/sv/latest/admin/install.md#static-files)):
   ```sh
   weblate collectstatic
   ```
6. Starta Celery-arbetarna. Detta är inte nödvändigt för utvecklingsändamål, men rekommenderas starkt i övriga fall. [Bakgrundsuppgifter med Celery](https://docs.weblate.org/sv/latest/admin/install.md#celery) har mer information:
   ```sh
   celery --app=weblate.utils worker --beat \
       --queues=celery,notify,memory,translate,backup \
       --prefetch-multiplier=1
   ```
7. Starta utvecklingsservern ([Körande server](https://docs.weblate.org/sv/latest/admin/install.md#server) beskriver en produktionskonfiguration):
   ```sh
   weblate runserver
   ```

## Efter installationen

Grattis, din Weblate-server är nu igång och du kan börja använda den.

* Du kan nu komma åt Weblate på `http://localhost:8000/`.
* Logga in med administratörsuppgifter som erhållits under installationen eller registrera dig med nya användare.
* You can now run Weblate commands using **weblate** command when
  Weblate Python environment is active, see [Ledningskommandon](https://docs.weblate.org/sv/latest/admin/management.md#manage).
* Du kan stoppa testservern med `Ctrl`+`C`.
* Granska eventuella problem med din installation antingen på URL:en `/manage/performance/` (se [Prestandarapport](https://docs.weblate.org/sv/latest/admin/admin.md#manage-performance)) eller med hjälp av **weblate check --deploy**, se [Produktionsuppsättning](https://docs.weblate.org/sv/latest/admin/install.md#production).

### Lägg till översättning

1. Öppna administratörsgränssnittet (`http://localhost:8000/create/project/`) och skapa det projekt du vill översätta. Se [Projektkonfiguration](https://docs.weblate.org/sv/latest/admin/projects.md#project) för mer information.

   Allt du behöver ange här är projektets namn och dess webbplats.
2. Skapa en komponent som är det verkliga objektet för översättning – den pekar på VCS-arkivet och väljer vilka filer som ska översättas. Se [Komponentkonfiguration](https://docs.weblate.org/sv/latest/admin/projects.md#component) för mer information.

   De viktiga fälten här är: [Komponentnamn](https://docs.weblate.org/sv/latest/admin/projects.md#component-name), [Källkodsarkiv](https://docs.weblate.org/sv/latest/admin/projects.md#component-repo) och [Filmask](https://docs.weblate.org/sv/latest/admin/projects.md#component-filemask) för att hitta översättningsbara filer. Weblate stöder ett brett utbud av format, inklusive [GNU gettext PO (Portable Object)](https://docs.weblate.org/sv/latest/formats/gettext.md#gettext), [Android-strängresurser](https://docs.weblate.org/sv/latest/formats/android.md#aresource), [Apple iOS-strängar](https://docs.weblate.org/sv/latest/formats/apple.md#apple), [Java-egenskaper](https://docs.weblate.org/sv/latest/formats/java.md#javaprop), [Stringsdict-format](https://docs.weblate.org/sv/latest/formats/stringsdict.md#stringsdict) eller [Fluent-format](https://docs.weblate.org/sv/latest/formats/fluent.md#fluent). Se [Lokalisering filformat](https://docs.weblate.org/sv/latest/formats.md#formats) för mer information.
3. När ovanstående är klart (det kan ta lång tid beroende på storleken på ditt VCS-arkiv och antalet meddelanden som ska översättas) kan du börja översätta.
