Hoppa till huvudinnehållet

Din första timme med fremforge

Den här sidan beskriver introduktionen ur köparens och administratörens perspektiv: vad du faktiskt klickar på och ser under den första timmen efter att du har bestämt dig för att registrera dig. Den kompletterar Kom igång, som är mer inriktad på utvecklare (SSH-nycklar, första repot, första CI-körningen).

Om det är du som blir den första ägaren av din fremforge-organisation bör du läsa den här sidan från början till slut innan du registrerar dig. Det mesta fungerar utan att du behöver göra något, men fyra små beslut under den här timmen avgör säkerhets- och faktureringsupplägget för hela din tid på fremforge. Det är mycket billigare att fatta dem rätt nu än att backa dem senare.

Flödet i överblick

                ┌──────────────────────────────────────────────────────────┐
                │  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                                 │
                └──────────────────────────────────────────────────────────┘

Hela flödet tar 15–30 minuter för en organisation med en enda administratör och utan SSO, eller 30–60 minuter om du kopplar in en IdP och bjuder in ett team.

1. Registrera dig

Gå till www.frem.sh och klicka på Sign up i toppmenyn (eller gå direkt till frem.sh/_app/signup). Registreringsformuläret frågar efter:

  • Jobbmejl: blir mejladressen för den första administratören och standardadressen för faktureringskontakt (du kan ändra båda senare).
  • Organisationens slug: 3–30 gemener, siffror och bindestreck. Det är URL-sökvägen till din organisation (frem.sh/<slug> för utvecklargränssnittet, frem.sh/<slug>/_admin/... för administrationen). Välj med omsorg: en slug ändras av operatören, inte via självbetjäning.
  • Visningsnamn: det som visas i gränssnittet när det inte finns plats för slugen.
  • Land: styr momshantering och bokföring. fremforge är bara för företag: för EU-länder krävs ett momsregistreringsnummer, för andra länder ett momsregistreringsnummer eller organisationsnummer (Norge: det niosiffriga organisationsnumret).
  • Momsregistreringsnummer eller organisationsnummer: för kunder i EU validerar vi numret direkt mot VIES innan organisationen skapas. Om ditt lands VIES-register är nere för tillfället (det händer ungefär en gång per kvartal och löser sig oftast inom 24 timmar) får du ett felmeddelande och kan försöka igen när registret är tillbaka.
  • Företagsförsäkran: en ruta där du bekräftar att du registrerar dig för ett företags räkning. fremforge säljer inte till konsumenter.

En proof-of-work-captcha körs när du skickar formuläret. Den tar 1–3 sekunder att lösa och är osynlig: du behöver inte klicka på några trafikljus.

Vanliga fallgropar:

  • Reserverade slugs (t.ex. admin, support, legal) och andra leverantörers varumärken (t.ex. github, gitlab) blockeras när du skickar formuläret. Välj något särpräglat.
  • Engångsmejltjänster blockeras; använd en riktig adress från företaget eller internetleverantören.

2. Verifiera din mejladress

Ett verifieringsmejl hamnar i inkorgen inom några sekunder. Länken gäller i 24 timmar och fungerar bara en gång. Klickar du två gånger provisioneras ingenting på nytt (det andra klicket visar bara din befintliga organisation).

Verifieringsmejlet skickas från noreply@frem.sh via Lettermint (förankrat i Nederländerna, leveransinfrastruktur enbart inom EU; ett av fremforges namngivna underbiträden enligt DPA:n). Om det inte har kommit fram inom 5 minuter, kontrollera skräpposten och företagets mejlfilter; avsändaradressen och DKIM ska stämma överens.

3. Bekräftelse → Mollie-kassan → organisationen provisioneras → välkomstmejl

Klicka på verifieringslänken och sedan på Skapa organisation på bekräftelsesidan. Du skickas vidare till Mollies hostade kassa för att godkänna ett betalningsmandat innan organisationen provisioneras. Mollie stöder kort, SEPA-autogiro, iDEAL, Bancontact och andra regionala betalningssätt. Verifieringen sker på 0 € (kortutgivaren kan tillfälligt reservera 0,01 € och omedelbart häva det som en del av den vanliga verifieringen). Ingenting debiteras under den 30 dagar långa provperioden: mandatet finns för att provperioden ska kunna övergå automatiskt på dag 30 utan ett extra steg i kassan. Du kan avbryta när som helst innan dess under Organisationens administration → Fakturering utan kostnad; vi skickar en påminnelse tre dagar före den automatiska debiteringen.

När Mollie har godkänt mandatet provisioneras organisationen, en första administratörsanvändare skapas och välkomstmejlet skickas. Den administratörsanvändaren är samma inloggning som ditt personliga fremforge-konto: registrerar du senare en andra organisation med samma mejladress återanvänds samma användare (inget andra konto).

Välkomstmejlet kommer inom några sekunder. Det innehåller inget lösenord. I stället innehåller det:

  • En knapp, ”Logga in på fremforge →”: en engångslänk för inloggning (kan användas en gång, går ut efter 48 timmar). När du klickar på den loggas du in automatiskt och hamnar på organisationens välkomstsida, där du ombeds att välja ett lösenord och konfigurera tvåfaktorsautentisering. (Om din registreringsadress redan hade ett fremforge-konto står det ”Öppna <your-slug> →” på knappen i stället, och du loggar in med ditt befintliga lösenord.)
  • Ditt administratörsanvändarnamn och din registreringsadress, under ”save this for break-glass recovery”. Båda fungerar som inloggning. Det finns inget lösenord att kopiera; det väljer du via länken ovan.
  • Fakturering: en länk ”Manage payment method →” och en påminnelse om att provperioden övergår automatiskt på dag 30.
  • Administrationens startsida att bokmärka: frem.sh/<your-slug>/_admin/overview.

Om välkomstmejlet uteblir men verifieringen fungerade, har organisationen skapats (mejlet skickas efter bästa förmåga). Logga då in via discovery-inloggningen med din registreringsadress och använd Forgot password för att välja ett lösenord.

4a. Logga in första gången

Ny organisation, ny administratör: klicka bara på ”Logga in på fremforge →” i välkomstmejlet. Länken loggar in dig automatiskt (det finns inget lösenord att skriva), ber dig sedan välja ett lösenord och slå på tvåfaktorsautentisering och tar dig till organisationens välkomstsida. Länken kan bara användas en gång och går ut efter 48 timmar. Har den gått ut innan du hann använda den loggar du in via discovery-inloggningen och använder Forgot password.

Befintligt fremforge-konto: på knappen i mejlet står det i stället ”Öppna <your-slug> →”. Logga in med det lösenord du redan har (användarnamn och registreringsadress fungerar båda).

Logga in senare

När ditt lösenord är valt når du organisationen från tre ingångar. Välj den du lättast kommer ihåg:

  • frem.sh/_app/login: discovery-inloggningen. Ange din mejladress; om organisationens domän är verifierad skickas du direkt till organisationens inloggning (SSO om det är konfigurerat, annars lösenord). Det är den här du ska dela med teamet.
  • frem.sh/<your-slug>/login: organisationens profilerade inloggning direkt. Visar organisationens SSO-knapp(ar) när SSO är konfigurerat; annars skickas du vidare till lösenordsinloggningen.
  • frem.sh/user/login: den universella lösenordsinloggningen, och din break-glass-väg om din IdP någon gång inte är tillgänglig. Tar alltid emot ditt användarnamn eller din registreringsadress plus lösenord.

Hela bilden, hur de tre hänger ihop, vad som ändras med SSO och regeln för break-glass, finns i Så fungerar inloggning.

Ditt användarnamn är ett stabilt kortnamn som används i URL:er (frem.sh/<username>), på författarrader i commits och i @mentions, men du behöver det sällan, eftersom mejladressen alltid fungerar som inloggning. Välj ett långt slumpmässigt lösenord från din lösenordshanterare; du kommer sällan att skriva det (se steg 7).

Första gången hamnar du på organisationens välkomstsida; därefter tar inloggningen dig till organisationens översikt på frem.sh/<your-slug> (”no repon yet” är normalt, du har ju inte pushat något). Om du först vill konfigurera SSO och bjuda in kollegor (rekommenderas), öppna steg 4b i en annan flik.

4b. Konfigurera din organisation (administrationens URL)

frem.sh/<your-slug>/_admin/overview är administrationens startsida: en översikt med snabblänkar till fakturering, SSO, säkerhet, medlemmar, granskningslogg och så vidare. Bokmärk den här URL:en. Är du administratör för flera fremforge-organisationer styrs administrationen av slugen i URL:en; det finns ingen organisationsväxlare i produkten, så du navigerar genom att skriva in eller bokmärka adressen.

Första gången du öppnar URL:en skickas du till organisationens inloggning (administrationssidorna kräver en autentiserad session). Efter inloggningen kommer du tillbaka hit.

Vid första besöket ser du:

  • Antal användare (standard 1: du, den första administratören).
  • Avtalsperiod: månadsvis (standard; byt till årsvis när som helst för att få rabatten på 15 %; du kan byta tillbaka till månadsvis först när den årliga perioden är slut).
  • Status för betalningsmetod: mandate active (Mollie-mandatet från registreringen), eller ”no method” med knappen Ställ in betalningsmetod om kassan vid registreringen avbröts eller mandatet sedan har återkallats hos kortutgivaren.
  • Status för provperioden: 30 dagars provperiod aktiv med datumet för den automatiska övergången.

Ser du ”no method” är det viktigaste att lägga till en betalningsmetod före dag 30 för att undvika avstängningsflödet. Annars kan du gå vidare till SSO och break-glass; faktureringen är redan på plats.

5. Konfigurera SSO (rekommenderas starkt på dag 1)

Om ditt team använder en SSO-leverantör (Okta, Entra, Google Workspace, Authentik, Keycloak, Auth0) bör du koppla in den innan du bjuder in någon. Gör du det först när kollegorna har konton med lokala lösenord krävs ett migreringssteg per användare.

Öppna Organisationens administration → SSO. Arbetet består av två delar:

  1. Verifiera din domän med en DNS TXT-post eller en HTTP-utmaning via .well-known/fremforge-domain.txt. Krävs innan du kan registrera en autentiseringskälla. Tar 1–5 minuter, förutsatt att du kan ändra DNS eller ladda upp en fil till domänens rot.

  2. Registrera en autentiseringskälla med OIDC. Formulären leder dig genom fälten på IdP-sidan. Se OIDC SSO för stegen per IdP, inklusive Entra ID och ADFS. SAML finns inte ännu.

Valfritt men rekommenderat för reglerade verksamheter: medan du ändå är i OIDC-formuläret kan du fylla i de tre fälten för Per-org session-binding step-up längst ned. De gör att IdP:n tvingas bekräfta identiteten på nytt vid åtkomst över organisationsgränser; se OIDC § Step-up med sessionsbindning per organisation för kraven på IdP-sidan. Hoppar du över fälten får du mjuk bindning i stället (fungerar fortfarande, bara utan tvingad ny inloggning hos IdP:n; break-glass med lokala inloggningsuppgifter finns kvar i båda fallen).

När en autentiseringskälla är registrerad provisioneras nästa person som loggar in via SSO automatiskt som fremforge-användare. SCIM (push-baserad provisionering) konfigureras separat; se SCIM 2.0.

6. Bekräfta faktureringsuppgifterna

Mandatet gavs vid registreringen, så här behöver du inte göra något för att aktivera faktureringen. Men det är under Organisationens administration → Fakturering som du bekräftar eller ändrar villkoren före den automatiska debiteringen på dag 30:

Priser (debiteras automatiskt på dag 30 om du inte avbryter innan):

  • Månadsvis: 30 € per användare och månad, faktureras i förskott i början av varje 30-dagarsperiod. Avbryt när som helst; åtkomsten fortsätter till slutet av den betalda månaden.
  • Årsvis: 306 € per användare och år (i praktiken 25,50 € per användare och månad, 15 % under listpris), faktureras i förskott som en årsavgift. Återbetalas inte om du avbryter mitt i perioden; åtkomsten fortsätter till slutet av den avtalade perioden och året räknas som betalt.

Det här kan du ändra före dag 30:

  • Avtalsperiod: byt från månadsvis till årsvis för att säkra rabatten på 15 %. Byte från månadsvis till årsvis kan ske när som helst; byte från årsvis till månadsvis träder i kraft först vid nästa förnyelse.
  • Användare: bjud in kollegor nu, så speglar debiteringen på dag 30 det faktiska antalet användare (varje inbjuden medlem räknas från det att hen tackar ja).
  • Betalningsmetod: ersätt Mollie-mandatet (t.ex. ett annat kort, eller byte från kort till SEPA-autogiro) via Replace payment method under Organisationens administration → Fakturering. Ersättningen går igenom samma verifiering på 0 € som Mollie använde vid registreringen.
  • Avbryt: åtgärden Avbryt provperioden upphäver mandatet och stoppar debiteringen på dag 30; organisationen behåller läsåtkomst under perioden för datalagring enligt villkoren §16.5.

Påminnelser: vi skickar ett meddelande 3 dagar före den automatiska debiteringen så att övergången inte kommer som en överraskning. Om Mollies automatiska debitering misslyckas på dag 30 (utgånget kort, otillräckligt saldo) får du de vanliga betalningspåminnelserna: tre nya försök under 14 dagar innan organisationen går över i skrivskyddad respitperiod.

7. Säkra break-glass-kontot

Den första administratören du just skapade är ditt break-glass-konto: behåll det, säkra det och radera det inte.

Varför: när du har kopplat in SSO och din IdP senare går ned (eller blir felkonfigurerad) är det break-glass-kontot som tar dig tillbaka in i organisationens administration, så att du kan stänga av SSO-kravet och släppa in teamet igen. Vägen beskrivs i SSO break-glass, och varje ägare bör öva den en gång.

Tre saker att göra nu, medan du ändå är inloggad:

  1. Byt det första lösenordet till ett långt slumpmässigt lösenord om du inte redan har gjort det. Generera ett lösenord på minst 24 tecken i en lösenordshanterare och spara det där. Du kommer sällan att skriva det.

  2. Slå på 2FA för det första kontot. Forgejo stöder TOTP (valfri autentiseringsapp) och WebAuthn/passkeys. 2FA på break-glass-kontot är ett krav, inte ett tillval: ett långt slumpmässigt lösenord utan 2FA är fortfarande en enda faktor som kan nätfiskas, och en break-glass-väg med bara en faktor motverkar hela poängen med att kräva SSO. Spara återställningskoderna i lösenordshanteraren (eller i ett förseglat kuvert i ett kassaskåp, inte i ett direktmeddelande på Slack).

  3. Kontrollera att den lokala inloggningen fungerar i ett privat webbläsarfönster innan du slår på SSO-reglaget Required. Öppna https://frem.sh/user/login, logga in med det lokala lösenordet och 2FA, och kontrollera att du når Organisationens administration → SSO. Gör det medan din vanliga session fortfarande är öppen i ett vanligt fönster, så att du kan rätta till det om något är fel.

För organisationer med mer än en mänsklig administratör: ha minst två ägare som är förberedda för break-glass. Om en av dem förlorar åtkomsten (borttappad enhet, stulen laptop, byte av anställning) kan den andra ägaren ge åtkomst på nytt utan att gå via supporten.

8. Bjud in kollegor

Gå till Organisationens administration → Medlemmar (frem.sh/<your-slug>/_admin/members) och välj Bjud in via e-post. Om du har kopplat in SSO behöver du inte bjuda in någon: medlemmar dyker upp under Organisationens administration → Medlemmar automatiskt första gången de loggar in via din identitetsleverantör, utan manuell provisionering per användare, och du ger åtkomst genom att mappa IdP-grupper till team under Organisationens administration → SSO. Med SSO inkopplat visar Medlemmar Skapa ett lokalt konto (nödåtkomst) i stället för Bjud in via e-post. Om du inte har kopplat in SSO får varje inbjuden ett konto med lokalt lösenord.

Varje inbjuden medlem räknas som en betald användare från det ögonblick hen tackar ja. fremforge har inga nivåer per användare; alla användare har samma fasta pris (30 € per månad, eller 306 € per år med årsavtal). Se Medlemmar och team för hela medlemskapsmodellen.

Det här ska du ha gjort när timmen är slut

En snabb checklista att gå igenom innan du är klar:

  • Organisationen är provisionerad, och både frem.sh/<your-slug> och frem.sh/<your-slug>/_admin/billing går att nå
  • Det första lösenordet är bytt till ett långt slumpmässigt lösenord, 2FA är påslaget och återställningskoderna är sparade
  • SSO är konfigurerat (autentiseringskälla registrerad, domän verifierad), eller så har du medvetet bestämt dig för att vänta med SSO
  • Hård step-up är konfigurerad (valfritt, för reglerade verksamheter), eller antecknad som en uppgift för fas 2
  • Faktureringsvillkoren är bekräftade (månadsvis eller årsvis, antal användare) inför den automatiska övergången på dag 30
  • Minst en kollega är inbjuden (eller antecknad som uppföljning)
  • Break-glass-proceduren är övad en gång: utloggad och inloggad igen med lokalt lösenord och 2FA i ett privat webbläsarfönster

Allt i listan som du har lämnat tomt är en känd uppföljning; skriv ned den. De två som ställer till det senare är MFA för break-glass och SSO-konfigurationen. Båda tar 15 minuter i dag, men blir ett flertimmarsprojekt när teamet väl använder fremforge aktivt.

Korsreferenser