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

# Bygga själv med GitHub Actions

Vill du bygga sajten själv — med din egen Hugo-version, npm, Tailwind, ett annat
verktyg än Hugo eller en egen testsvit — kan du göra det i din CI och skicka det
färdiga resultatet till oss. Vi publicerar det precis som det är.

Allt annat fungerar som vanligt: din egen domän, HTTPS, domänverifiering, sparade
versioner och mejl om något går fel.

Det finns två sätt. **Uppladdning** är enklast: ditt workflow skickar den färdiga
sajten direkt till oss. Vill du hellre att vi hämtar den från ditt repo går det
också, via en egen gren.

## Sätt 1: Ladda upp (rekommenderas) \{#satt-1-ladda-upp-rekommenderas}

```
git push  ──▶  GitHub Actions bygger  ──▶  laddar upp till oss  ──▶  publicerad
```

Vi behöver ingen åtkomst till ditt repo alls — ingen deploynyckel och ingen webhook.

### 1. Lägg uppladdningsadressen som en hemlighet \{#1-lagg-uppladdningsadressen-som-en-hemlighet}

Uppladdningsadressen finns under din tjänst i portalen
(**Tjänster → GetGeek Static → Uppladdningsadress**). Lägg in den sista delen av
adressen — nyckeln efter `/upload/<sajt>/` — som en hemlighet i ditt repo:
**Settings → Secrets and variables → Actions → New repository secret**, med
namnet `GETGEEK_UPLOAD_TOKEN`.

:::warning Uppladdningsnyckeln styr vad din sajt visar
Till skillnad från webhook-adressen kan den här nyckeln ändra innehållet på din
sajt. Lägg den bara som en hemlighet i GitHub, aldrig i en fil i repot. Tror du
att den läckt, tryck **Ny webhook- och uppladdningsnyckel** på tjänstesidan. Den gamla nyckeln slutar fungera när bytet är klart, normalt inom 1–2 minuter.
:::

### 2. Lägg till ett workflow \{#2-lagg-till-ett-workflow}

```yaml title=".github/workflows/deploy.yml"
name: Bygg och publicera

on:
  push:
    branches: [main]

permissions:
  contents: read

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v7
        with:
          submodules: true

      - uses: peaceiris/actions-hugo@v3
        with:
          hugo-version: "0.165.0"
          extended: true

      - run: hugo --minify

      - name: Publicera hos GetGeek Static
        env:
          UPLOAD_URL: https://static.getgeek.se/upload/<sajt>/${{ secrets.GETGEEK_UPLOAD_TOKEN }}
        run: |
          tar -C public -czf site.tar.gz .
          curl --fail-with-body -sS --data-binary @site.tar.gz "$UPLOAD_URL"
```

Byt `<sajt>` mot ditt sajtnamn (det står i uppladdningsadressen i portalen).
Byggsteget kan du ändra fritt — det enda vi bryr oss om är arkivet: ett `tar.gz`
med den färdiga sajten och `index.html` överst.

Workflowet behöver bara **läsrätt** till repot (`contents: read`), eftersom inget
pushas tillbaka.

### Bra att veta om uppladdning \{#bra-att-veta-om-uppladdning}

- **Svar `202`** = mottaget, sajten publiceras inom några sekunder. `403` = fel
  nyckel, `413` = arkivet är större än 1 GB, `415` = inte ett `tar.gz`-arkiv.
- **Går publiceringen fel** — till exempel om `index.html` saknas — får du ett mejl,
  och din sajt fortsätter visa senaste fungerande version.
- **Symboliska länkar publiceras aldrig.** Ett arkiv som innehåller sådana avvisas.
- **Samma arkiv två gånger** ger ingen ny version.
- Det fungerar likadant från **alla CI-system** och från din egen dator — det är
  ett vanligt HTTP-anrop.

## Sätt 2: Via grenen gh-pages \{#satt-2-via-grenen-gh-pages}

```
git push  ──▶  GitHub Actions bygger  ──▶  grenen gh-pages  ──▶  vi publicerar filerna
```

Här pushar ditt workflow resultatet till en gren i ditt repo, och vi hämtar den med
deploynyckeln. Det passar om du vill ha den byggda sajten versionerad i git.

### 1. Lägg till ett workflow (gh-pages) \{#1-lagg-till-ett-workflow-gh-pages}

Skapa filen `.github/workflows/deploy.yml` i ditt repo:

```yaml title=".github/workflows/deploy.yml"
name: Bygg och publicera

on:
  push:
    branches: [main]

permissions:
  contents: write

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v7
        with:
          submodules: true

      - uses: peaceiris/actions-hugo@v3
        with:
          hugo-version: "0.165.0"
          extended: true

      - run: hugo --minify

      - uses: peaceiris/actions-gh-pages@v4
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}
          publish_dir: ./public
          publish_branch: gh-pages
```

Workflowet bygger sajten vid varje push till `main` och lägger det färdiga
resultatet i grenen `gh-pages`. Byt gärna byggsteget mot vad du vill — det enda
vi bryr oss om är att `gh-pages` innehåller den färdiga sajten, med `index.html`
överst.

:::info Vad används `GITHUB_TOKEN` till?
Bara inne i GitHub, för att workflowet ska kunna pusha den byggda sajten till
grenen `gh-pages` i ditt eget repo.

- Det är ingen hemlighet du skapar själv. GitHub skapar automatiskt en token för
  varje körning, och den slutar gälla när jobbet är klart.
- Den gäller bara ditt repo, med de rättigheter workflowet ber om. Därför står
  `permissions: contents: write` i filen — steget som pushar till `gh-pages`
  behöver skrivrätt.
- **Den lämnar aldrig GitHub, och GetGeek ser den aldrig.** Vår åtkomst till ditt
  repo är bara deploynyckeln, som är läsbehörig. Vi hämtar `gh-pages` efter att
  GitHub har pushat dit.

Vill du inte ge workflowet skrivrätt via `GITHUB_TOKEN` kan `actions-gh-pages`
i stället använda en egen deploynyckel med skrivbehörighet (`deploy_key:` i
stället för `github_token:`). Resultatet blir detsamma, men det är en nyckel
till att hålla reda på.
:::

### 2. Välj läget _Färdigbyggd gren i repot_ \{#2-tala-om-for-oss-att-sajten-ar-fardigbyggd}

Välj _Färdigbyggd gren i repot_ i beställningen, eller byt senare med länken
**Uppgradera/nedgradera** under _Hur publicerar ni sajten?_ på tjänstesidan (gratis). Lämna _Gren_ tom för `gh-pages`. Sajten
ställs då in så att vi bara kopierar grenen.

### 3. Deploynyckel, webhook och DNS \{#3-deploynyckel-webhook-och-dns}

Precis som vanligt — se [Koppla GitHub](/static/github.md) och
[Kom igång](/static/kom-igang.md#steg-4-dns). Webhooken ska skicka vid push.

### Bra att veta om gh-pages \{#bra-att-veta-om-gh-pages}

- **GitHub skickar webhooken för pushar till alla grenar.** När du pushar till
  `main` hör vi av oss direkt, men ser att `gh-pages` inte har ändrats än och gör
  ingenting. När ditt workflow sedan pushar till `gh-pages` publicerar vi.
  Räkna med en halv minut från push till publicerad sajt.
- **Publiceringen är en ren kopia.** Filen `.nojekyll`, som workflowet lägger i
  grenen, följer med men gör ingen skillnad.
- **Ställ inte in `cname`** i `actions-gh-pages` — den gäller GitHub Pages, inte oss.
- **Går ditt bygge fel** syns det i GitHub (fliken _Actions_), inte i ett mejl
  från oss: grenen `gh-pages` ändras då inte, och din sajt fortsätter visa senaste
  version.
- **Andra CI-system** fungerar på samma sätt — GitLab CI, Gitea Actions och andra
  — så länge resultatet pushas till en egen gren i repot.
