Skip to main content

Welcome to ForgePortal ⚡

ForgePortal is an open-source Internal Developer Portal (IDP) — self-hosted, built on PostgreSQL, Fastify, React, and TypeScript. It gives your engineering org a single place to discover services, scaffold new ones, enforce quality standards, and extend the platform with plugins — all without forking or maintaining a complex system.

What is ForgePortal?

An Internal Developer Portal is the homepage for your engineering platform. It answers:

  • What services do we have?Software Catalog
  • How do I create a new service?Templates & Scaffolding
  • How healthy are our services?Scorecards
  • How do I integrate my tool?Plugin System

ForgePortal is the platform you build once and use forever. Unlike Backstage (which we love and drew inspiration from), ForgePortal is designed to be:

PriorityHow ForgePortal delivers it
Fast to set updocker compose up → working portal in 5 minutes
Simple to operateTwo services (API + Worker), one database (PostgreSQL)
Easy to extendnpx create-forge-plugin → new plugin in 2 minutes
Safe by defaultOIDC auth, RBAC, secret redaction, webhook verification out of the box

Where to start

I want to try it now

Quick Start (Docker Compose)

I want to build a plugin

Plugin Developer Guide

I want to understand the concepts

Core Concepts

I want to deploy it in production

Deployment Guide