Getting Started

Get started with Forge

Getting Started with Forge

Sign up

Visit Forge and create an account. Choose whether to start fresh or import from an existing platform.

Connect your repositories

Forge works by scanning your code and CI systems. Set it up:

  1. Click Connect Git provider
  2. Authorize GitHub, GitLab, or Bitbucket
  3. Select repositories (or allow Forge to scan all)

Forge auto-discovers services from your repo structure, Dockerfile, and deployment config.

Explore the service catalog

Visit the Service catalog to see all discovered services:

  • Each service shows ownership, deploy status, and links to repos
  • Forge automatically pulls in README, codeowners, and CI config
  • You can manually add services that weren't auto-discovered

Generate documentation scaffolds

For any service, click Generate docs. Forge creates skeletons for:

  • Overview
  • Architecture diagram
  • API reference
  • Deployment guide
  • Runbooks

Engineers fill in the context; the structure is already there.

Set up team pages

Organize knowledge by team:

  1. Go to Teams
  2. Create a team and add members
  3. Link services and documentation to the team
  4. Set up a team-specific knowledge base

New engineers onboarding to a team start with the team page.

Onboard new engineers

When someone joins:

  1. Go to Onboarding
  2. Create an onboarding checklist for their role
  3. Forge auto-populates: repos to clone, services to understand, people to meet
  4. Share the checklist with the new person

They have a clear first-week roadmap.

Next steps

  • Read about Forge's Features to learn more
  • Check the Roadmap to see what's coming
  • Write battle-tested runbooks for your critical services