> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.

# Kom igång

Från beställning till sajt i drift tar det ungefär 15 minuter av din tid. Själva
publiceringen sker sedan automatiskt vid varje push.

## Steg 1: Beställ \{#steg-1-bestall}

Beställ GetGeek Static i portalen:
**[https://portal.getgeek.se/index.php/cart/webbhosting/\&action=add\&id=931](https://portal.getgeek.se/index.php/cart/webbhosting/\&action=add\&id=931)**

I beställningen fyller du i:

| Fält                      | Exempel                            | Kommentar                                                                                                                                                                                                          |
| ------------------------- | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Hur publicerar ni sajten? | _Vi bygger med Hugo från ert repo_ | Tre val: _Ladda upp färdig sajt från CI_ (förvalt), _Vi bygger med Hugo från ert repo_ och _Färdigbyggd gren i repot_. Se [Bygga själv](/static/egen-byggpipeline.md) för de två alternativen där du bygger själv. |
| Git-repo (SSH-adress)     | `git@gitlab.com:min-org/sajt.git`  | Bara om ni inte laddar upp. SSH-adressen, inte https. Repot får vara privat.                                                                                                                                       |
| Gren                      | `main`                             | Tomt = `main`. För _Färdigbyggd gren i repot_ är tomt = `gh-pages`.                                                                                                                                                |
| Hugo-version              | `0.165.0`                          | Tomt = vår standardversion (just nu 0.165.0). Fyll bara i om du behöver en annan version.                                                                                                                          |
| Domän(er), max 5          | `www.exempel.se, exempel.se`       | Den första blir huvuddomän.                                                                                                                                                                                        |
| E-post för byggfel        | `webb@exempel.se`                  | Hit skickas mejl om ett bygge misslyckas. Tomt = kontots e-postadress.                                                                                                                                             |

Allt det här kan du ändra senare, se [Hantera din sajt i portalen](/static/portalen.md).

## Steg 2: Det här hittar du i portalen \{#steg-2-det-har-far-du-av-oss}

När sajten är uppsatt hittar du uppgifterna på tjänstesidan i portalen (se [Hantera din sajt i portalen](/static/portalen.md)):

1. **Status** — per domän om den är verifierad, aktuell version och resultatet
   av senaste publiceringen.
2. **En deploynyckel** (när vi hämtar från ditt repo) — en publik SSH-nyckel som
   ger oss _läsbehörighet_ till ditt repo. Den kan inte ändra något.
3. **En webhook-adress** (när vi hämtar från ditt repo), i formen
   `https://static.getgeek.se/hook/<sajt>/<token>`. Den talar om för oss att det
   finns något nytt att bygga.
4. **En uppladdningsadress** (när du laddar upp en färdigbyggd sajt från CI), se
   [Bygga själv](/static/egen-byggpipeline.md).
5. **En verifieringskod** per domän, `gg-static-…`, som visar att domänen är din
   (se steg 4).

:::warning Webhook-adressen är en hemlighet
Den sista delen av adressen är en nyckel. Den kan bara starta ett bygge av det
som redan finns i ditt repo — den kan aldrig ändra din sajt — men dela den inte
i onödan. Tror du att den läckt, tryck **Ny webhook- och uppladdningsnyckel** på tjänstesidan.
:::

## Steg 3: Koppla ditt repo \{#steg-3-koppla-ditt-repo}

Lägg in deploynyckeln och webhooken i ditt git. Det skiljer sig lite mellan
tjänsterna:

- [GitLab](/static/gitlab.md) (med skärmbilder)
- [GitHub](/static/github.md)
- [Gitea, Forgejo, Codeberg, Bitbucket och andra](/static/andra-git.md)

## Steg 4: DNS \{#steg-4-dns}

Lägg in två poster för **varje** domän hos din DNS-leverantör.

**Peka domänen mot oss.** För en underdomän, till exempel `www.exempel.se`:

```
www.exempel.se.    CNAME   static.getgeek.se.
```

För en domän utan prefix (`exempel.se`) går det inte att använda CNAME — DNS-standarden
tillåter det inte på zonens topp. Lägg i stället in båda adresserna:

```
exempel.se.    A       94.142.251.165
exempel.se.    AAAA    2a12:5bc1::165
```

Adresserna är fasta och byts inte. Lägg in både A och AAAA, så når sajten besökare
över både IPv4 och IPv6.

**Visa att domänen är din**, med verifieringskoden du fick i steg 2:

```
_getgeek-static.www.exempel.se.    TXT    "gg-static-…"
_getgeek-static.exempel.se.        TXT    "gg-static-…"
```

:::info Varför en TXT-post?
Utan den skulle vem som helst kunna be oss publicera en sajt på _din_ domän,
om den råkar peka mot oss — till exempel en gammal CNAME som blivit kvar.
TXT-posten bevisar att du styr domänens DNS. Samma metod används av GitLab
Pages och de flesta liknande tjänster. Koden är unik för din sajt.

Vi kontrollerar posten automatiskt var tionde minut. När den hittas får du ett
mejl om att domänen är verifierad — du behöver inte höra av dig. Därefter behöver
posten inte finnas kvar, men den gör ingen skada om den gör det.
:::

## Steg 5: Pusha \{#steg-5-pusha}

Pusha något till din gren. Inom några sekunder:

1. tar vi emot webhooken,
2. hämtar ditt repo med deploynyckeln,
3. bygger sajten med Hugo,
4. publicerar den.

Första gången din domän används hämtar vi också ett certifikat från Let's Encrypt.
Det tar en halv minut till några minuter — men först när DNS-posterna har slagit
igenom. Har du nyss ändrat DNS kan det dröja upp till någon timme, beroende på
hur länge de gamla svaren cachas.

Klart! Från och med nu publiceras sajten vid varje push. Går ett bygge fel får du
ett mejl, och din sajt fortsätter visa senaste fungerande version.
