Gå til hovedinnhold

Din første time med fremforge

Denne siden beskriver oppstarten sett fra kjøperen og administratoren: hva du faktisk klikker på og ser i den første timen etter at du har bestemt deg for å registrere deg. Den utfyller Kom i gang, som er mer rettet mot utviklere (SSH-nøkler, første repo, første CI-kjøring).

Hvis det er du som blir den første eieren av fremforge-organisasjonen din, bør du lese denne siden fra start til slutt før du registrerer deg. Det meste skjer uten at du trenger å gjøre noe, men fire små beslutninger i løpet av denne timen legger sikkerhets- og faktureringsoppsettet for resten av tiden din på fremforge. Det er mye billigere å ta dem riktig nå enn å rulle dem tilbake senere.

Flyten i oversikt

                ┌──────────────────────────────────────────────────────────┐
                │  1. Sign up at www.frem.sh                               │
                │     email + org slug + country/VAT + Altcha PoW          │
                └─────────────────────────┬────────────────────────────────┘
                                          │
                                          ▼
                ┌──────────────────────────────────────────────────────────┐
                │  2. Verification email arrives (Lettermint, EU)          │
                │     click within 24h                                     │
                └─────────────────────────┬────────────────────────────────┘
                                          │
                                          ▼
                ┌──────────────────────────────────────────────────────────┐
                │  3. Confirm page → Mollie hosted checkout (card / SEPA)  │
                │     mandate captured at €0 → tenant + Forgejo org        │
                │     provisioned → welcome email with a one-time link     │
                └─────────────────────────┬────────────────────────────────┘
                                          │
                            ┌─────────────┴─────────────┐
                            ▼                           ▼
            ┌─────────────────────────┐   ┌──────────────────────────────┐
            │  4a. Sign in            │   │  4b. Configure your org      │
            │  frem.sh/_app/login     │   │  frem.sh/<slug>/_admin/   │
            │  → your dashboard       │   │  billing — wire SSO, invite, │
            │                         │   │  review billing              │
            └─────────────────────────┘   └──────────────────────────────┘
                                          │
                            ┌─────────────┴─────────────┐
                            ▼                           ▼
            ┌─────────────────────────┐   ┌──────────────────────────────┐
            │  5. Wire SSO            │   │  6. Confirm billing details  │
            │  (optional but strongly │   │  monthly vs. annual term,    │
            │  recommended on day 1)  │   │  seats, VAT — auto-converts  │
            │                         │   │  on day 30 of trial          │
            └─────────────────────────┘   └──────────────────────────────┘
                                          │
                                          ▼
                ┌──────────────────────────────────────────────────────────┐
                │  7. Harden the break-glass account (MFA on local owner)  │
                │     and invite teammates                                 │
                └──────────────────────────────────────────────────────────┘

Hele flyten tar 15–30 minutter for en organisasjon med én administrator og uten SSO, eller 30–60 minutter hvis du kobler til en IdP og inviterer et team.

1. Registrer deg

Gå til www.frem.sh og klikk på Sign up i toppmenyen (eller gå rett til frem.sh/_app/signup). Registreringsskjemaet ber om:

  • Jobb-e-post: denne blir e-postadressen til den første administratoren og standardadressen for faktureringskontakt (du kan endre begge senere).
  • Organisasjonens slug: 3–30 små bokstaver, sifre og bindestreker. Dette er URL-stien til organisasjonen din (frem.sh/<slug> for utviklerflaten, frem.sh/<slug>/_admin/... for administrasjonsflaten). Velg med omhu: endringer av slug håndteres av operatøren og kan ikke gjøres med selvbetjening.
  • Visningsnavn: det som vises i grensesnittet når det ikke er plass til slugen.
  • Land: styrer MVA-behandling og bokføring. fremforge er bare for virksomheter: EU-land krever et MVA-nummer, andre land et MVA-nummer eller organisasjonsnummer (Norge: det 9-sifrede organisasjonsnummeret).
  • MVA-nummer eller organisasjonsnummer: for kunder i EU kontrollerer vi nummeret direkte mot VIES før organisasjonen opprettes. Hvis VIES-registeret for landet ditt er nede akkurat da (det skjer omtrent én gang i kvartalet og løser seg vanligvis innen et døgn), får du en feilmelding og kan prøve igjen når registeret er oppe.
  • Virksomhetserklæring: en avkrysningsboks der du bekrefter at du registrerer deg på vegne av en virksomhet. fremforge selger ikke til forbrukere.

En proof-of-work-captcha kjører når du sender inn skjemaet. Den bruker 1–3 sekunder og er usynlig, så du slipper å klikke på trafikklys.

Vanlige fallgruver:

  • Reserverte slugs (for eksempel admin, support, legal) og andre leverandørers varemerker (for eksempel github, gitlab) blir avvist ved innsending. Velg noe særpreget.
  • Leverandører av engangs-e-post blir avvist; bruk en ekte adresse fra bedriften eller internettleverandøren din.

2. Bekreft e-postadressen din

En bekreftelses-e-post kommer i innboksen din i løpet av sekunder. Lenken er gyldig i 24 timer og fungerer bare én gang. Klikker du to ganger, blir ingenting opprettet på nytt (det andre klikket viser bare organisasjonen du allerede har).

Bekreftelses-e-posten sendes fra noreply@frem.sh via Lettermint (forankret i Nederland, leveringsinfrastruktur bare i EU; en av fremforges navngitte underdatabehandlere i henhold til DPA-en). Hvis den ikke har kommet etter 5 minutter, sjekker du søppelposten og bedriftens e-postfilter; From-adressen og DKIM skal være justert.

3. Bekreftelse → Mollie-kassen → organisasjonen opprettes → velkomst-e-post

Klikk på bekreftelseslenken, og klikk deretter på Opprett organisasjon på bekreftelsessiden. Du sendes videre til Mollies hostede kasse for å godkjenne et betalingsmandat før organisasjonen opprettes. Mollie støtter kort, SEPA Direct Debit, iDEAL, Bancontact og andre regionale betalingsmåter. Kontrollen skjer på 0 € (kortutstederen din kan kortvarig reservere 0,01 € og frigi beløpet med en gang som en del av standardkontrollen). Ingenting faktureres i løpet av den 30 dager lange prøveperioden. Mandatet finnes for at prøveperioden skal kunne gå over til betalt abonnement automatisk på dag 30 uten et ekstra steg i kassen. Du kan si opp når som helst før det under Organisasjonsadministrasjon → Fakturering uten kostnad; vi sender en påminnelse tre dager før den automatiske belastningen.

Når Mollie har godtatt mandatet, opprettes organisasjonen din og en første administratorbruker, og velkomst-e-posten sendes. Denne administratorbrukeren er den samme innloggingen som den personlige fremforge-kontoen din. Hvis du senere registrerer en organisasjon til med samme e-postadresse, brukes den samme brukeren (ingen ny konto).

Velkomst-e-posten kommer i løpet av noen sekunder. Det står ikke noe passord i den. I stedet inneholder den:

  • Én knapp, «Logg inn i fremforge →»: en engangslenke for innlogging (kan brukes én gang, utløper etter 48 timer). Et klikk logger deg inn automatisk og sender deg til velkomstsiden for organisasjonen, der du blir bedt om å velge et passord og sette opp tofaktorautentisering. (Hvis e-postadressen du registrerte deg med, allerede hadde en fremforge-konto, står det i stedet «Åpne <your-slug> →» på knappen, og du logger inn med passordet du allerede har.)
  • Administratorbrukernavnet og registrerings-e-posten din, vist under «save this for break-glass recovery». Begge kan brukes til å logge inn. Det er ikke noe passord å kopiere; du velger det via lenken ovenfor.
  • Fakturering: en lenke «Manage payment method →» og en påminnelse om at prøveperioden går over til betalt abonnement automatisk på dag 30.
  • Administrasjonsforsiden du bør lagre som bokmerke: frem.sh/<your-slug>/_admin/overview.

Hvis velkomst-e-posten ikke kommer, men bekreftelsen fungerte, er organisasjonen din opprettet (e-posten sendes etter beste evne). Logg inn via discovery-innloggingen med registrerings-e-posten din, og bruk Glemt passord for å velge et passord.

4a. Logg inn første gang

Ny organisasjon, ny administrator: klikk bare på «Logg inn i fremforge →» i velkomst-e-posten. Lenken logger deg inn automatisk (det er ikke noe passord å skrive inn), ber deg deretter velge et passord og slå på tofaktorautentisering, og sender deg til velkomstsiden for organisasjonen. Lenken kan brukes én gang og utløper etter 48 timer. Hvis den utløper før du har brukt den, logger du inn via discovery-innloggingen og bruker Glemt passord.

Eksisterende fremforge-konto: knappen i e-posten heter i stedet «Åpne <your-slug> →». Logg inn med passordet du allerede har (både brukernavn og registrerings-e-post fungerer).

Innlogging senere

Når passordet er satt, fører tre innganger til organisasjonen din. Velg den du husker best:

  • frem.sh/_app/login: discovery-innloggingen. Skriv inn e-postadressen din. Hvis organisasjonens domene er bekreftet, sendes du rett til organisasjonens innlogging (SSO hvis du har koblet det til, ellers passord). Det er denne du bør dele med teamet ditt.
  • frem.sh/<your-slug>/login: organisasjonens egen innlogging, direkte. Viser SSO-knappen(e) når SSO er koblet til; ellers sendes du videre til passordinnloggingen.
  • frem.sh/user/login: den universelle passordinnloggingen, og din break-glass-vei hvis IdP-en din noen gang er utilgjengelig. Godtar alltid brukernavn eller registrerings-e-post + passord.

Hele bildet, med hvordan disse tre henger sammen, hva som endrer seg med SSO, og regelen for break-glass, finner du i Slik fungerer innlogging.

Brukernavnet ditt er et fast, kort navn som brukes i URL-er (frem.sh/<username>), i forfatterlinjer på commits og i @mentions. Du trenger det sjelden, for e-postadressen godtas alltid som innloggingsnavn. Velg et langt, tilfeldig passord fra passordbehandleren din; du kommer sjelden til å skrive det inn (se trinn 7).

Første gang havner du på velkomstsiden for organisasjonen. Senere tar innloggingen deg til organisasjonens dashbord på frem.sh/<your-slug> («no repositories yet» er normalt, for du har ikke pushet noe ennå). Hvis du vil sette opp SSO og invitere kolleger først (anbefalt), åpner du trinn 4b i en annen fane.

4b. Konfigurer organisasjonen din (administrasjons-URL-en)

frem.sh/<your-slug>/_admin/overview er administrasjonsforsiden: en oversikt med snarveier til fakturering, SSO, sikkerhet, medlemmer, revisjonslogg og så videre. Lagre denne URL-en som bokmerke. Er du administrator for flere fremforge-organisasjoner, styres administrasjonsflaten av slugen i URL-en. Det finnes ingen organisasjonsvelger i produktet; du navigerer ved å skrive URL-en eller bruke bokmerker.

Første gang du åpner denne URL-en, sendes du til organisasjonens innlogging (administrasjonssidene krever en innlogget økt). Etter innloggingen kommer du tilbake hit.

Ved første besøk ser du:

  • Antall brukere (standard 1: deg, den første administratoren).
  • Avtaleperiode: månedlig (standard; bytt til årlig når som helst for å få rabatten på 15 %; du kan først bytte tilbake til månedlig når den årlige perioden er over).
  • Status for betalingsmåte: mandate active (Mollie-mandatet fra registreringen), eller «no method» med knappen Set up payment hvis kassen ble avbrutt ved registreringen eller mandatet senere er trukket tilbake hos kortutstederen din.
  • Status for prøveperioden: 30-day trial active, med datoen for automatisk overgang til betalt abonnement.

Ser du «no method», er det viktigst å legge til en betalingsmåte før dag 30 for å unngå suspensjonsflyten. Ellers går du videre til SSO og break-glass; faktureringen er allerede satt opp.

5. Koble til SSO (sterkt anbefalt på dag 1)

Hvis teamet ditt bruker en SSO-leverandør (Okta, Entra, Google Workspace, Authentik, Keycloak, Auth0), bør du koble den til før du inviterer noen. Setter du det opp etter at kolleger har fått kontoer med lokalt passord, må hver bruker migreres.

Åpne Organisasjonsadministrasjon → SSO. Det er to oppgaver:

  1. Bekreft domenet ditt, med en DNS TXT-post eller en HTTP-utfordring via .well-known/fremforge-domain.txt. Dette må være på plass før du kan registrere en autentiseringskilde. Det tar 1–5 minutter, forutsatt at du kan redigere DNS eller laste opp en fil til roten av domenet ditt.

  2. Registrer en autentiseringskilde med OIDC. Skjemaene guider deg gjennom feltene på IdP-siden. Se OIDC SSO for oppsettet per IdP, inkludert Entra ID og ADFS. SAML er ikke tilgjengelig ennå.

Valgfritt, men anbefalt for regulerte arbeidslaster: mens du er i OIDC-skjemaet, fyller du ut de tre feltene for Per-org session-binding step-up nederst. De gjør at IdP-en tvinges til å bekrefte identiteten på nytt ved tilgang på tvers av organisasjoner; se OIDC § Per-org session-binding step-up for kravene på IdP-siden. Hopper du over disse feltene, faller du tilbake til myk binding (fungerer fortsatt, bare uten tvungen ny forespørsel fra IdP-en; break-glass med lokal legitimasjon er bevart uansett).

Når en autentiseringskilde er registrert, opprettes neste person som logger inn via SSO, automatisk som fremforge-bruker. SCIM (push-basert provisjonering) settes opp separat; se SCIM 2.0.

6. Bekreft faktureringsopplysningene

Mandatet ble registrert ved registreringen, så du trenger ikke gjøre noe her for å slå på fakturering. Men det er under Organisasjonsadministrasjon → Fakturering du bekrefter eller endrer vilkårene før den automatiske belastningen på dag 30:

Priser (belastes automatisk på dag 30 med mindre du sier opp før det):

  • Månedlig: 30 € per bruker per måned, fakturert forskuddsvis ved starten av hver 30-dagersperiode. Du kan si opp når som helst; tilgangen varer ut den gjeldende betalte måneden.
  • Årlig: 306 € per bruker per år (i praksis 25,50 € per bruker per måned, 15 % under listepris), fakturert forskuddsvis som ett årsbeløp. Refunderes ikke hvis du sier opp midt i perioden; tilgangen varer til datoen du har forpliktet deg til, og året regnes som betalt.

Hva du kan endre før dag 30:

  • Avtaleperiode: bytt fra månedlig til årlig for å sikre deg rabatten på 15 %. Du kan bytte fra månedlig til årlig når som helst; fra årlig til månedlig gjelder først ved neste fornyelse.
  • Brukere: inviter kolleger nå, så gjenspeiler belastningen på dag 30 det faktiske antallet brukere (hvert invitert medlem teller fra det øyeblikket invitasjonen godtas).
  • Betalingsmåte: erstatt Mollie-mandatet (for eksempel et annet kort, eller bytt fra kort til SEPA Direct Debit) via Replace payment method under Organisasjonsadministrasjon → Fakturering. Erstatningen går gjennom den samme kontrollen på 0 € som Mollie brukte ved registreringen.
  • Oppsigelse: handlingen Cancel trial annullerer mandatet og stopper belastningen på dag 30. Organisasjonen beholder lesetilgang gjennom oppbevaringsperioden for data i henhold til vilkårene §16.5.

Påminnelser: vi sender et varsel 3 dager før den automatiske belastningen, slik at overgangen ikke kommer som en overraskelse. Hvis Mollies automatiske belastning feiler på dag 30 (utløpt kort, manglende dekning), får du de vanlige purre-e-postene: tre nye forsøk over 14 dager før organisasjonen går over i en periode med bare lesetilgang.

7. Styrk break-glass-kontoen

Den første administratoren du nettopp opprettet, er break-glass-kontoen din, altså nødtilgangen. Behold den, styrk den, og ikke slett den.

Hvorfor: når du har koblet til SSO og IdP-en din senere går ned (eller blir feilkonfigurert), er det break-glass-kontoen som gir deg tilgang til organisasjonsadministrasjonen igjen, slik at du kan slå av SSO-kravet og slippe teamet ditt inn. Framgangsmåten er beskrevet i Break-glass for SSO, og alle eiere bør øve på den én gang.

Tre ting du bør gjøre nå, mens du allerede er innlogget:

  1. Bytt det første passordet til et langt, tilfeldig passord hvis du ikke allerede har gjort det. Generer et passord på minst 24 tegn i en passordbehandler, og lagre det. Du kommer sjelden til å skrive det inn.

  2. Slå på 2FA for den første administratorkontoen. Forgejo støtter TOTP (hvilken som helst autentiseringsapp) og WebAuthn / passnøkler. 2FA på break-glass-kontoen er påkrevd, ikke valgfritt: et langt, tilfeldig passord uten 2FA er fortsatt én enkelt faktor som kan fiskes, og hvis break-glass-veien er en innlogging med én faktor, faller poenget med å kreve SSO bort. Lagre gjenopprettingskodene i passordbehandleren din (eller i en forseglet konvolutt i en safe, ikke i en direktemelding på Slack).

  3. Kontroller at den lokale innloggingen fungerer i et privat nettleservindu før du slår på SSO-bryteren Påkrevd. Åpne https://frem.sh/user/login, logg inn med det lokale passordet + 2FA, og bekreft at du kommer til Organisasjonsadministrasjon → SSO. Gjør dette mens den vanlige økten din fortsatt er åpen i et vanlig vindu, slik at du kan rette opp hvis noe er galt.

For organisasjoner med mer enn én menneskelig administrator: ha minst to eiere som er forberedt på break-glass. Hvis den ene mister tilgangen (mistet enhet, stjålet bærbar PC, endring i ansettelsesforholdet), kan den andre eieren gi ny tilgang uten å gå via kundestøtte.

8. Inviter kolleger

Gå til Organisasjonsadministrasjon → Medlemmer (frem.sh/<your-slug>/_admin/members) og velg Inviter via e-post. Hvis du har koblet til SSO, trenger du ikke invitere noen: medlemmer dukker opp på Organisasjonsadministrasjon → Medlemmer automatisk første gang de logger inn via identitetsleverandøren din, uten manuell provisjonering per bruker, og du gir tilgang ved å koble IdP-grupper til team i Organisasjonsadministrasjon → SSO. Med SSO koblet til viser Medlemmer Opprett en lokal konto (break-glass) i stedet for Inviter via e-post. Hvis du ikke har koblet til SSO, får hver invitert person en konto med lokalt passord.

Hvert invitert medlem teller som en betalt bruker fra det øyeblikket invitasjonen godtas. fremforge har ingen nivåer per bruker; alle brukere har den samme faste prisen (30 € per måned, eller 306 € per år med årlig avtale). Se Medlemmer og team for hele medlemskapsmodellen.

Dette bør du ha gjort når timen er omme

En rask sjekkliste å gå gjennom før du sier deg ferdig:

  • Organisasjonen er opprettet, og både frem.sh/<your-slug> og frem.sh/<your-slug>/_admin/billing kan nås
  • Det første passordet er byttet til et langt, tilfeldig passord + 2FA er slått på + gjenopprettingskodene er lagret
  • SSO er koblet til (autentiseringskilde registrert, domene bekreftet), eller du har bevisst bestemt deg for å utsette SSO
  • Hard step-up er koblet til (valgfritt, for regulerte arbeidslaster), eller notert som en oppgave for fase 2
  • Faktureringsvilkårene er bekreftet (månedlig eller årlig, antall brukere) før den automatiske overgangen på dag 30
  • Minst én kollega er invitert (eller notert som oppfølging)
  • Break-glass-framgangsmåten er øvd på én gang: logget ut og logget inn igjen med lokalt passord + 2FA i et privat nettleservindu

Alt du har latt stå tomt i denne listen, er en kjent oppfølging: skriv det ned. De to som pleier å svi senere, er MFA på break-glass-kontoen og oppsettet av SSO. Begge er en jobb på 15 minutter i dag, men et rot som tar flere timer å rydde opp i når teamet ditt bruker fremforge aktivt.

Se også