# Komma igång

> Produkt A · 2026-10-30 · https://groovy.simplo.dev/produkt-a/komma-igang

Installera och konfigurera din första instans.

Den här sektionen guidar dig genom installation och grundkonfiguration.

## Installation

Så installerar du systemet på din server.

### Förutsättningar

Innan du börjar behöver du säkerställa att din miljö uppfyller kraven nedan.

- PHP 8.3 eller senare
- En databas (MySQL eller PostgreSQL)
- Skrivrättigheter i katalogen `cache/`

> [!NOTE]
> Vi rekommenderar alltid den senaste stabila versionen av PHP för bästa
> prestanda och säkerhet.

### Ladda ner paketet

Hämta senaste paketet och packa upp det i din webbrot.

```bash
curl -LO https://example.com/app.tar.gz
tar -xzf app.tar.gz -C /var/www/app
```

#### Filstruktur

Efter uppackning ser katalogstrukturen ut ungefär så här:

| Katalog | Beskrivning |
| --- | --- |
| `bin/` | Kommandoradsverktyg |
| `config/` | Konfigurationsfiler |
| `public/` | Webbrot |

### Verifiera installationen

Starta den inbyggda kontrollen för att verifiera att allt fungerar.

```bash
php bin/check --verbose
```

> [!WARNING]
> Kör aldrig kontrollverktyget mot en produktionsdatabas utan att först ta en
> säkerhetskopia.

När kontrollen är klar och rapporterar OK kan du gå vidare till
[konfiguration](https://groovy.simplo.dev/produkt-a/komma-igang/konfiguration).

## Konfiguration

Anpassa systemet efter din miljö.

### Konfigurationsfilen

All grundkonfiguration sker i `config/app.yaml`. Filen läses vid uppstart och
kan kompletteras med miljövariabler.

```yaml
app:
  name: Min app
  environment: production
  debug: false
```

#### Miljövariabler

Följande variabler kan overridas via miljön, vilket är praktiskt i
containerbaserade driftsättningar.

- `APP_ENV`
- `APP_DEBUG`
- `APP_DATABASE_URL`

### Databasanslutning

Ange anslutningssträngen i formatet nedan.

```text
mysql://user:password@localhost:3306/app
```

> [!TIP]
> Använd en dedikerad databasanvändare med minimala rättigheter i
> produktionsmiljö.

### Loggning

Loggnivåer styrs separat och kan sättas per modul.

| Nivå | Användning |
| --- | --- |
| `debug` | Utveckling |
| `info` | Normal drift |
| `error` | Endast fel |

> [!CAUTION]
> Att lämna `debug: true` aktiverat i produktion kan läcka känslig
> information i loggarna.

Fortsätt till [guider](https://groovy.simplo.dev/produkt-a/guider) för mer avancerade ämnen.
