Sist endret: 29. okt. 2026
Preview: Dette er dokumentasjonen for Altinn Studio v9, som er en forhåndsversjon. Gjeldende versjon er v8. For å se dokumentasjonen for gjeldende versjon, velg v8 i versjonsvelgeren i menyen til venstre.

Installere og sette opp studioctl

Slik installerer du studioctl, logger inn og henter appen til egen maskin.

studioctl er et kommandolinjeverktøy fra Altinn Studio. Du bruker det når du skal jobbe med appen på egen maskin i stedet for i Altinn Studio Designer. Med studioctl kan du

  • logge inn i Altinn Studio og hente appen til maskinen din
  • teste appen på egen maskin
  • oppgradere appen til en ny versjon av Altinn Studio

Vi anbefaler studioctl når du skal oppgradere appen. Det er som regel utvikleren eller leverandøren din som installerer og bruker verktøyet. Jobber du ikke selv med koden, kan du sende denne siden til dem.

studioctl er foreløpig en forhåndsversjon (v0.1.0-preview). Nye versjoner kan ha brytende endringer. Se endringsloggen for studioctl før du oppdaterer.

Dette trenger du

studioctl virker på Windows, macOS og Linux. På maskinen må du også ha

  • Git, slik at studioctl kan hente appen fra Altinn Studio
  • .NET SDK, slik at du kan kjøre appen
  • Docker, Podman eller Colima, slik at du kan starte den lokale testplattformen

Skal du oppgradere appen til v9, trenger du .NET SDK 11 eller nyere. Bruker du en forhåndsversjon av .NET 11, må den være 11.0.100-rc.2 eller nyere.

Når du har installert studioctl, kan du kontrollere at du har alt du trenger.

Installer studioctl

Kjør denne kommandoen i en terminal på Mac og Linux:

curl -sSL https://altinn.studio/designer/api/v1/studioctl/install.sh | sh

På Windows kjører du denne kommandoen i PowerShell:

iwr https://altinn.studio/designer/api/v1/studioctl/install.ps1 -useb | iex

Installasjonen kan spørre deg hvor du vil legge studioctl. Den installerer også det studioctl trenger for å kjøre den lokale testplattformen.

Logg inn og hent appen

  1. Logg inn i Altinn Studio:
    studioctl auth login
    Nettleseren åpner Altinn Studio, og du logger inn med Ansattporten som vanlig. studioctl husker innloggingen på maskinen din.
  2. Hent appen. Bytt ut <org> med kortnavnet til virksomheten din og <app-name> med navnet på appen:
    studioctl app clone <org>/<app-name>
    Du kan også lime inn lenken til app-repoet i stedet for <org>/<app-name>.
  3. Gå til mappen studioctl har laget for appen:
    cd <app-name>

Nå har du en kopi av appen på maskinen din. studioctl har også satt opp Git, slik at du kan laste opp endringene dine til Altinn Studio igjen.

I automatiske byggeløp og andre steder der ingen kan logge inn i nettleseren, kan du sende inn en eksisterende API-nøkkel for Altinn Studio. I eksempelet ligger nøkkelen i en miljøvariabel:

printf '%s' "$STUDIO_DESIGNER_API_KEY" | studioctl auth login --with-token

Kontroller oppsettet

Kjør denne kommandoen:

studioctl doctor

Kommandoen sjekker blant annet at du har .NET SDK og Docker, Podman eller Colima. Mangler noe, viser den hva det er. Den sjekker ikke om .NET-versjonen er ny nok til å oppgradere til v9. Det sjekker studioctl app upgrade selv før den endrer noe i appen.

Oppdater studioctl

Det kommer jevnlig nye versjoner av studioctl. Hent siste versjon før du oppgraderer appen:

studioctl self update

Trenger du en bestemt versjon, legger du til --version, for eksempel studioctl self update --version v0.1.0-preview.29.

Neste steg