Getting started Guide
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
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:
- Add organizations and administrators - Configure your team structure
- Access the Setup Guide - Follow the comprehensive checklist for essential plugins
- Personalization - Use the Config Manager at
/config-manager
to customize your Portal - 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