---
title: CLI
description: >-
  Installér linkdash-cli fra npm, og kør derefter kommandoen `linkdash`.
  Kommandoer, der lykkes, skriver JSON til stdout. Hjælp og fejl er ren tekst på
  stderr.
sidebar:
  label: CLI
  order: 3
---
```bash
npm i -g linkdash-cli
# or: pnpm add -g linkdash-cli / bun add -g linkdash-cli / npx linkdash-cli@latest
```

npm-pakken hedder `linkdash-cli`. Kommandoen hedder `linkdash`.

Tilsvarende over HTTP: [HTTP API](/da/api). MCP: [MCP](/da/mcp). Agent-skill: [Agent-skill](/da/skill). Priser: [Priser](/da/pricing). Ren markdown: [cli.md](https://linkdash.dev/cli.md).

Der findes ikke noget `--json`-flag. Ved fejl er exitkoden 1.

## Godkendelse

```bash
linkdash auth create
linkdash auth login
linkdash auth whoami
linkdash auth logout
```

Har du ikke en konto endnu? `auth create` åbner https://linkdash.dev/sign-up og sender dig derefter videre til https://linkdash.dev/device med CLI-koden, så du kan godkende. Har du allerede en konto? `auth login` åbner `/device`. Uden browser: Sæt `LINKDASH_TOKEN` til et sessionstoken fra `auth create` eller `auth login`. Find ikke selv på tokens.

Sessionsfil: `~/.config/linkdash/config.json` (mode 0600).

CLI'en kan ikke ændre e-mail, adgangskode eller betaling. Send brugeren til [dashboardet](https://linkdash.dev/dashboard/billing). API-nøgler (HTTP og MCP): [API-nøgler](https://linkdash.dev/dashboard/keys).

## Kommandoer

```
linkdash <command> [options]
```

| Kommando | Hvad den gør |
| --- | --- |
| `auth create` | Tilmelding i browseren, derefter godkendelse af enheden |
| `auth login` | Login på enheden via browseren |
| `auth logout` | Glem den gemte session |
| `auth whoami` | JSON for den konto, du er logget ind med |
| `links list` | Vis links og mapper, én side ad gangen (`--limit`, `--cursor`) |
| `links get <id>` | Ét link |
| `links create --url <url>` | Kort link fra en URL |
| `links create --file <path>` | Upload en fil og få et link |
| `links create --text <text>` | Gem et tekststykke |
| `links create --folder <name>` | Opret en [mappe](/da/folders) |
| `links create --variant <name> …` | Link med flere varianter (split / målretning) |
| `links update <id>` | Skift destination, fil, adgangskode, udløb, domæne, status, sticky eller videresendte parametre |
| `links move <id> --in <folder-id>` | Læg et link eller en mappe i en mappe (`--root` for øverste niveau) |
| `links copy <id>` | Lav en kopi med en ny slug i samme mappe |
| `links delete <id>` | Slet et link (indholdet i en mappe rykker et niveau op; `--with-contents` sletter det) |
| `links share <id> --email <email>` | [Del](/da/sharing) med folk via e-mail (gentag `--email`; `--role editor` lader dem ændre det; hver ny person får en invitation på e-mail) |
| `links unshare <id> --email <email>` | Fjern en persons adgang |
| `links shares [id]` | Hvem der ud over dig kan åbne det, også via en mappe længere oppe. Uden id: alt, du har inviteret folk til, én side ad gangen (`--limit`, `--cursor`) |
| `links shared` | Det, andre har delt med dig, én side ad gangen (`--limit`, `--cursor`) |
| `links leave <_id \| share URL>` | Opgiv noget, der er delt med dig |
| `links role <id> --email <e> --role viewer\|editor` | Gør en, du har inviteret, til læser eller redaktør |
| `links unlock <_id \| share URL>` | Indtast adgangskoden til et delt element for at se og redigere dets mål i 30 minutter |
| `links activity <id>` | Hvem der har ændret et element, og hvordan |
| `links reset-link <id>` | Ny delings-URL; den gamle `linkdash.dev/s/`-URL holder op med at virke |
| `links stats <id>` | Totaler for besøg, downloads og afspilninger, også pr. variant, plus crawlere |
| `links export` | Udskriv alle links som CSV (én række pr. variant) |
| `links import <file>` | Importér URL- og tekstrækker fra CSV |
| `links variants list <id>` | Et links varianter |
| `links variants add <id> --name <n>` | Tilføj en variant |
| `links variants update <id> <name>` | Ændr en variant |
| `links variants remove <id> <name>` | Fjern en variant |
| `webhooks list` | Vis webhook-endpoints (secret maskeret) |
| `webhooks get <id>` | Vis én webhook-URL (secret maskeret) |
| `webhooks create --url <https>` | Tilføj et HTTPS-endpoint (secret vises én gang) |
| `webhooks rotate <id>` | Udsted en ny signerings-secret |
| `webhooks delete <id>` | Fjern en webhook |
| `domains list` | Vis egne værtsnavne |
| `domains add <host>` | Tilføj et værtsnavn (1 på Free) |
| `domains connect <host>` | Domain Connect-URL til opsætning, eller null |
| `domains verify <host>` | Tjek DNS med Unkey |
| `domains remove <host>` | Fjern et værtsnavn |
| `-h, --help` | Hjælp (ren tekst) |
| `-v, --version` | Version |

Hvis den samme slug findes på to af ejerens domæner, skal du angive `--domain`.

## Flag til oprettelse og opdatering

Slug er linkets id og dets offentlige sti, når linket er offentligt. Navnet er kun synligt for dig. Nye links er begrænsede (se [Adgang og deling](#access-and-sharing)). Oprettelse tager **præcis én** af `--url`, `--file` eller `--text` (som bliver til varianten `main`), `--variant`-blokke (se [Varianter](#variants)) eller `--folder <name>` (se [Mapper](#folders)).

| Flag | Noter |
| --- | --- |
| `--url <url>` | Destinations-URL |
| `--file <path>` | Fil, der skal uploades (ved oprettelse, eller erstat indholdet ved opdatering) |
| `--text <text>` | Tekststykke |
| `--access <restricted\|link\|public>` | Hvem der kan åbne det. Standard er `restricted`. Se [Adgang og deling](#access-and-sharing) |
| `--reset-share-link` | Udsted en ny delings-URL (kun ved opdatering) |
| `--slug <id>` | Offentlig sti: `a-z0-9` og bindestreger inde i ordet, 1–64 |
| `--name <label>` | Privat etiket |
| `--tag <tag>` | Kan gentages. Små bogstaver, ingen kommaer. Maks. 20 |
| `--starts <when>` | Gå live efter `7d`, `24h`, `30m` eller en ISO-dato |
| `--password <secret>` | Kræv denne adgangskode for at åbne |
| `--expires <when>` | Stop med at levere efter `7d`, `24h`, `30m` eller en ISO-dato |
| `--max-openings <n>` | Sæt på pause efter så mange åbninger. Udelad for ubegrænset |
| `--domain <host>` | Lever på denne vært i stedet for `lida.sh` |
| `--in <folder-id>` | Opret inde i denne mappe (kun ved oprettelse; `--in-domain <host>`, hvis mappens slug går igen) |
| `--status <active\|paused>` | Sæt på pause eller genoptag (kun ved opdatering) |
| `--sticky` / `--no-sticky` | En tilbagevendende besøgende beholder den samme variant (standard er sticky) |
| `--restart-split` | Bland sticky-tildelingerne på ny (kun ved opdatering) |
| `--forward-params` / `--no-forward-params` | Tilføj den besøgendes query string til URL-varianter (standard er slået fra). Se [Videresend query-parametre](#forward-query-parameters) |
| `--variant <name>` | Start en variantblok (kun ved oprettelse). Se [Varianter](#variants) |
| `--weight <n>` `--when <key=v1,v2>` | Pr. variant. Se [Varianter](#variants) og [Regler for query-parametre](#query-parameter-rules) |
| `--preview-name <text>` | Offentligt navn i linkforhåndsvisning |
| `--preview-description <text>` | Offentlig beskrivelse i linkforhåndsvisning |
| `--preview-image <path>` | Offentligt billede i linkforhåndsvisning |
| `--utm-source` `--utm-medium` `--utm-campaign` `--utm-term` `--utm-content` | Kun URL-links |
| `--clear-password` `--clear-expires` `--clear-starts` `--clear-tags` `--clear-preview` `--clear-name` `--clear-max-openings` | Kun ved opdatering |

`--status` accepterer kun `active` eller `paused`. Udløbet kommer fra `--expires`. Planlagt kommer fra `--starts`. Offentlig opslag giver not-found indtil start. Når `--max-openings` er nået, sættes linket på pause; hæv tallet eller brug `--clear-max-openings` for at levere det igen. Åbninger, der allerede er brugt, tæller stadig, indtil du ændrer eller fjerner grænsen.

Slugs på `lida.sh` er fælles. Hvis et ord er taget, så tilføj et [eget domæne](/da/domains) og prøv igen med `--domain`. Et link på et brandet domæne bliver ikke også udgivet på `lida.sh`.

## Flag til list

Udskriver én side, `{items, cursor}`: `--limit` er 1-100 (standard 50); angiv `--cursor` med `cursor` fra den forrige side, indtil den er `null`. En side kan indeholde færre elementer end `--limit`, når et filter springer nogle over. `--q` matcher hele ord, hvor det sidste bruges som præfiks (`laun` finder `example.com/launch`), sorteret efter relevans; `--in` viser én mappe med mapper først; ellers nyeste først.

| Flag | Noter |
| --- | --- |
| `--limit <n>` | Elementer pr. side, 1-100 (standard 50) |
| `--cursor <c>` | `cursor` fra den forrige side |
| `--q <text>` | Søg efter ord i navn, slug, variantnavne og -mål, filnavne, tekststykker og tags |
| `--tag <tag>` | Filtrér efter tag |
| `--kind <url\|file\|text\|folder\|group>` | Filtrér efter type (`group` = flere varianter) |
| `--status <status>` | `active`, `paused`, `expired`, `scheduled` eller `mixed` |
| `--in <folder-id\|root>` | Kun det, der ligger direkte i denne mappe eller på øverste niveau. Uden flaget vises alt |

## Varianter

Hvert link er en beholder med én eller flere **varianter**. En variant er indholdet (URL, fil eller tekst) plus dens egen spærre (`--password`, `--starts`, `--expires`, `--max-openings`), en `--weight` og valgfrie betingelser for besøgende (`--when`). Uden `--variant` har et link én variant ved navn `main`, og alle kommandoerne ovenfor er en genvej til den. En besøgende får én variant: Varianter, hvis `--when` matcher, udgør puljen (hvis ingen matcher, gør de ubetingede varianter), og derefter vælges der vægtet. Med sticky-tildeling (standard) beholder en tilbagevendende besøgende den samme variant. Linkets egen spærre vinder over variantspærrer. Variantnavne: små bogstaver, cifre, bindestreger inde i ordet, 1–40 tegn, unikke pr. link. Maks. 20 varianter.

Linkets `kind` er variantens type ved én variant og `group` ved flere. Linkets `status` er linkspærren, når den er sat (`paused`, `scheduled`, `expired`), ellers den fælles variantstatus, ellers `mixed`. `variantStatuses` tæller `{active, paused, expired, scheduled}`.

### Opret med variantblokke

```bash
linkdash links create --slug promo --variant a --url https://example.com/a --variant b --url https://example.com/b --weight 3
linkdash links create --slug hi --variant de --url https://example.de --when country=DE,AT --variant rest --url https://example.com
```

`--variant <name>` starter en variantblok. Flag efter den hører til den variant indtil næste `--variant`: `--url|--file|--text`, `--password`, `--starts`, `--expires`, `--max-openings`, `--weight <n>`, `--when <key=v1,v2>` (kan gentages), `--utm-*`. Linkflag (`--slug --name --tag --domain --preview-* --password --starts --expires --max-openings --sticky --no-sticky --forward-params`) skal stå før den første `--variant`.

### Underkommandoer til varianter

```bash
linkdash links variants list promo
linkdash links variants add promo --name mobile --url https://m.example.com --when device=mobile
linkdash links variants update promo mobile --when country=DE,AT --when device=mobile --weight 2
linkdash links variants update promo b --status paused
linkdash links variants remove promo b
```

`variants add <id> --name <n>` tager én af `--url`, `--file`, `--text` plus spærreflag, `--weight`, `--when`, `--utm-*`. `variants update <id> <name>` tager `--name <new>`, indhold, spærreflag, `--status active|paused`, `--weight`, `--when`, `--clear-when`, `--clear-password`, `--clear-starts`, `--clear-expires`, `--clear-max-openings`. Et link har altid mindst én variant.

### `--when`-nøgler

| Nøgle | JSON-felt | Værdier |
| --- | --- | --- |
| `country` | `countries` | ISO-2-koder (`DE`, `AT`) |
| `device` | `devices` | `mobile` `tablet` `desktop` |
| `os` | `os` | `windows` `macos` `android` `ios` `linux` `other` |
| `browser` | `browsers` | `edge` `chrome` `firefox` `safari` `other` |
| `language` | `languages` | præfiksmatch (`de`, `en-us`) |
| `referrer` | `referrerHosts` | værtssuffiks (`twitter.com`) |

Alle angivne nøgler skal matche. `--when country=DE,AT --when device=mobile` svarer til `{ "countries": ["DE","AT"], "devices": ["mobile"] }`.

### Regler for query-parametre

`--when` tager også `param:`-regler for den besøgendes query string (`lida.sh/promo?src=newsletter`). Nøgler skelner mellem store og små bogstaver, værdier sammenlignes præcist, og der er maks. 10 regler pr. variant. Kommaer deler `--when` op, så en parameterværdi kan ikke indeholde et komma; brug `|` til lister.

| Syntaks | JSON `op` | Matcher, når |
| --- | --- | --- |
| `param:KEY=VALUE` | `equals` | værdien er præcis `VALUE` |
| `param:KEY!=VALUE` | `notEquals` | værdien er en anden, eller nøglen mangler |
| `param:KEY~=VALUE` | `includes` | værdien indeholder `VALUE` |
| `param:KEY^=VALUE` | `startsWith` | værdien starter med `VALUE` |
| `param:KEY$=VALUE` | `endsWith` | værdien slutter med `VALUE` |
| `param:KEY=v1\|v2` | `in` | værdien er en af dem på listen |
| `param:KEY?` eller `param:KEY` | `exists` | nøglen findes |
| `param:!KEY` | `missing` | nøglen mangler |

```bash
linkdash links variants add promo --name news --url https://example.com/news --when param:src=newsletter
linkdash links variants add promo --name pro --url https://example.com/pro --when "param:plan~=pro"
linkdash links variants add promo --name ref --url https://example.com/ref --when "param:ref?"
```

JSON-form: `"when": { "params": [{ "key": "src", "op": "equals", "value": "newsletter" }] }` (`value` udelades for `exists` / `missing`). Parameterværdier matches, når linket åbnes, og gemmes aldrig i analytics.

### Videresend query-parametre

`--forward-params` / `--no-forward-params` på `links create` og `links update` (på linkniveau, slået fra som standard) tilføjer den besøgendes hele query string til URL-varianter: `lida.sh/promo?src=nl` åbner `https://example.com/?src=nl`. Den besøgendes værdier overskriver de gemte, også `--utm-*`. Fil- og tekstvarianter ignorerer det. Det er routing, ikke adgangskontrol: Alle kan tilføje parametre. Parameterværdier gemmes ikke i analytics. `links get` viser det som `forwardParams`.

### Sticky og genstart af split

`links update <id> --sticky` / `--no-sticky` bestemmer, om en tilbagevendende besøgende beholder den samme variant. `links update <id> --restart-split` blander sticky-tildelingerne på ny. Indholdsflag på `links update` virker kun for links med én variant; ellers skal du bruge `links variants update <id> <name>`.

## Mapper

En mappe er et link, der viser de elementer, du lægger i den. Se [Mapper](/da/folders) for, hvordan den offentlige side og adgang fungerer.

```bash
linkdash links create --folder "Q4 launch" --slug q4
linkdash links create --file ./deck.pdf --in q4
linkdash links move k3m9xq --in q4
linkdash links move k3m9xq --root
linkdash links list --in q4
linkdash links copy k3m9xq
linkdash links delete q4 --with-contents
```

`--folder <name>` sætter mappens navn (ikke `--name`) og tager `--slug`, `--domain`, `--password`, `--starts`, `--expires`, `--max-openings`, `--tag`, `--preview-*` og `--in`. Det kan ikke kombineres med `--url`, `--file`, `--text` eller `--variant`. `links move` udskriver `{id, folder}`. `links copy` beholder adgangsniveauet, men får en ny delings-URL; personer kopieres ikke med. `links delete` på en mappe rykker dens elementer et niveau op; `--with-contents` sletter dem også. Rækker fra list, get og create indeholder `folder` (slug for den mappe, de ligger i, eller `null`); mapperækker indeholder også `items`.

## Adgang og deling

Nye links og mapper er `restricted`: Deres `url` er `https://linkdash.dev/s/<token>`, som kun du og de personer, du deler med, kan åbne, når de er logget ind. `--access link` åbner den URL for alle, der har den. `--access public` leverer linket på dets korte URL (`lida.sh/<slug>` eller dit eget domæne). Brug `--access public` til links, du offentliggør. Slug forbliver id'et for alle kommandoer, og dens korte URL forbliver reserveret, mens linket ikke er offentligt. Se [Deling og adgang](/da/sharing) for hele modellen.

```bash
linkdash links create --url https://example.com/launch --access public
linkdash links share q4 --email anna@example.com --email ben@example.com
linkdash links shares q4
linkdash links unshare q4 --email ben@example.com
linkdash links shared
linkdash links leave https://linkdash.dev/s/<token>
linkdash links share q4 --email cara@example.com --role editor
linkdash links role q4 --email cara@example.com --role viewer
linkdash links unlock https://linkdash.dev/s/<token>
linkdash links activity q4
linkdash links shares
linkdash links update q4 --access link
linkdash links reset-link q4
```

| Kommando | Udskriver |
| --- | --- |
| `links share <id> --email <e> [--email <e> …]` | `{id, url, access, invited, alreadyShared}` |
| `links unshare <id> --email <e>` | `{id, email, removed: true}` |
| `links shares <id>` | `{id, access, url, people: [{email, role: "viewer", accepted, invitedAt, viaFolder?}]}` |
| `links shares` (uden id) | `{items: [{id, name?, kind, access, url, people: [{email, accepted, invitedAt}]}], cursor}`, senest delte først |
| `links shared` | `{items: [{_id, _creationTime, kind, title?, status, hasPassword, access, url, itemCount?, sharedBy?, sharedAt}], cursor}`, nyeste først |
| `links leave <_id \| share URL>` | `{_id, left: true}` |
| `links role <id> --email <e> --role <r>` | `{id, email, role}` |
| `links unlock <_id \| share URL>` | `{_id, variant, unlocked: true, minutes: 30, kind, destinationUrl? \| textContent? \| fileName?}` |
| `links activity <id>` | `{items: [{_id, _creationTime, action, detail?, actor}], cursor}` |
| `links reset-link <id>` (eller `links update <id> --reset-share-link`) | `{id, access, url}` |

`--role editor` gør en person til redaktør: De kan ændre elementet og se dets statistik, men ikke adgangskoder, slug, domæne, adgang eller deling, og de kan ikke slette, flytte eller kopiere. Et adgangskodebeskyttet mål kræver først `links unlock` (30 minutter). Redaktører bruger `_id` eller delings-URL'en fra `links shared`. Alle tager `--domain <host>`, når slug går igen. `url` i output fra `create`, `get`, `list`, `update`, `copy` og `share` er delings-URL'en, medmindre linket er offentligt – så er det den korte URL; rækker indeholder `access`. Op til 200 personer pr. element, 50 e-mails pr. kald og 100 invitationsmails pr. konto pr. dag. De to lister udskriver én side: `--limit` er 1-100 (standard 50); angiv `--cursor` fra den forrige side, indtil `cursor` er `null`. `links leave` tager `_id` eller `url` fra `links shared`; adgang via en delt mappe længere oppe bevares. Deling, fjernelse af deling, en adgangsændring og en nulstilling tæller hver som én hændelse; at forlade gør ikke.

## Statistik

```bash
linkdash links stats <id> --last 24h
```

`--last` er en varighed (`24h`, `7d`). Standard er `24h`. JSON indeholder `visits`, `downloads`, `plays`, `visitsInLast`, `countries`, `referrers`, `variants` (totaler pr. variant), `visitors` (hver med `variant`) og `crawlers` (`[{crawler, company, category, hits, lastSeen}]`: bots og linkforhåndsvisninger, der har hentet linket, og som aldrig tælles som besøg).

## CSV

Kolonner: `slug,kind,name,variant,url,text,fileName,status,domain,tags,starts,expires,maxOpenings,weight,when,created,folder,access`. Én række pr. variant. `kind`, `status`, `url`, `text`, `fileName`, `weight` og `when` (JSON-streng) er pr. variant; resten er pr. link og gentages. `folder` er slug for den mappe, linket ligger i. `access` er `restricted`, `link` eller `public`. Ingen adgangskoder, delingstokens eller personer.

```bash
linkdash links export > links.csv
linkdash links import links.csv
```

Import grupperer rækker efter slug + domæne. Den første række opretter linket med dets variant; flere rækker tilføjer varianter. For et eksisterende link opdaterer den første række linkfelterne, og derefter opdaterer hver række varianten med det navn, hvis den findes, ellers tilføjes den. Filrækker uden indhold springes over med en fejl for den række. Rækker med `kind` = `folder` (med et `name`) opretter mapper; kolonnen `folder` placerer hvert link i sin mappe, når alle rækker findes. En tom `access` gør nye links begrænsede og lader eksisterende links være, som de er.

## Eksempler

```bash
linkdash links create --url https://example.com/q4/deck.pdf --slug deck --name "Q4 deck"
linkdash links create --file ./deck.pdf --expires 7d --starts 1d
linkdash links create --url https://example.com --max-openings 1
linkdash links update k3m9xq --max-openings 5
linkdash links update k3m9xq --clear-max-openings
linkdash links create --text "release checklist" --tag launch --tag q4
linkdash links list --q deck --tag launch --kind file --status paused
linkdash links get welcome --domain go.example.com
linkdash links update deck --file ./new.pdf
linkdash links update k3m9xq --status paused
linkdash links create --slug promo --variant a --url https://example.com/a --variant b --url https://example.com/b --weight 3
linkdash links variants add promo --name mobile --url https://m.example.com --when device=mobile
linkdash links update promo --no-sticky --restart-split
linkdash links create --folder "Q4 launch" --slug q4
linkdash links move k3m9xq --in q4
linkdash links create --url https://example.com/launch --access public
linkdash links share q4 --email anna@example.com
```

Se også [mapper](/da/folders), [deling og adgang](/da/sharing), [webhooks](/da/webhooks) og [egne domæner](/da/domains).
