Skip to main content

Getting started Guide

tip

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

Setup Configuration Wizard

Step 1 of 3

What do you use for your identity provider?

This is how your team members will sign into Portal

Supported Identity Providers

GitHub

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

→ GitHub Setup Guide

Okta

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

→ Okta Setup Guide

Entra ID

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

→ Entra ID Setup Guide

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
info

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