Skip to main content

Documentation Index

Fetch the complete documentation index at: https://backstage.spotify.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Spotify Portal brings together your tools, services, documentation, and APIs in one unified developer experience. This guide will help you set up Portal quickly and start unlocking productivity benefits for your engineering teams.

​
Prerequisites

Before you start, make sure you have the following:
  • Your Portal domain
  • Access to your identity provider (GitHub, Okta, or Entra ID)
  • Admin permissions for your chosen identity provider

​
Supported Identity Providers

GitHub

Integrate with GitHub for repository access and user authentication. Supports both OAuth Apps and GitHub Apps.

Okta

Enterprise single sign-on with Okta identity provider for secure user access and management.

Entra ID

Microsoft Entra ID (formerly Azure Active Directory) for enterprise authentication integration.

​
Next Steps

After completing authentication setup:
  1. Add organizations and administrators - Configure your team structure
  2. Access the Setup Guide - Follow the comprehensive checklist for essential plugins
  3. Personalization - Use the Config Manager at /config-manager to customize your Portal
  4. Onboard your team - Start adding services and team members to the Software Catalog
After completing the Setup Wizard, you’ll gain access to the Setup Guide with:
  • A detailed checklist of essential plugins
  • Step-by-step configuration instructions
  • Links to documentation and troubleshooting
  • Best practices for Portal implementation