Backstage 101: Building Internal Developer Portals
Learn to build developer portals with Backstage, the open-source platform created by Spotify. Master the five core pillars: Service Catalog, Software Templates, TechDocs, Authentication, and Search. Build a working developer portal from scratch, starting with local development and progressing through Docker to production Kubernetes deployment.
Why This Course is Different
Get everything you need to master platform engineering and advance your career
Certificate of Completion
Earn a certificate while gaining real-world skills that go beyond traditional certification prep
Hands-on Labs
11 practical labs with real-world scenarios in pre-configured cloud environments
Expert-Led
Learn from Sam Gabrail, Former HashiCorp Sr. Solutions Engineer with 15+ years experience
Community Support
Join our community where members help each other and collaborate on learning
What You'll Master
Set up and run Backstage locally, in Docker, and in production Kubernetes
Create and manage a Software Catalog with services, teams, and documentation
Build Software Templates that help developers create new projects quickly
Configure TechDocs for documentation-as-code workflows
Set up authentication with OIDC providers specifically: Keycloak
Build a complete developer portal with all five core Backstage features
Import sample organizations with proper service relationships
Create 'golden path' templates for common project types
Set up automated discovery from GitHub repositories
Configure basic group mapping and permissions
Develop simple plugins to extend Backstage functionality
Configure the Kubernetes plugin for developer visibility into workloads
Map catalog entities to Kubernetes resources using annotations
Understand business value and adoption measurement strategies
Integrate ArgoCD with Backstage for GitOps deployment visibility
Build production-ready templates with complete CI/CD pipelines
Experience end-to-end developer self-service workflows
Configure GitHub Actions workflows with proper permissions for container registry access
Implement multi-stage Docker builds for production security and efficiency
Deploy services to dedicated namespaces following production best practices
Integrate GitHub Container Registry (GHCR) for Docker image storage
Understand GitOps principles with Git as the single source of truth
Course Curriculum
SECTION 1 – WHY IDPS AND BACKSTAGE BASICS
Understanding Internal Developer Portals, setting up Backstage locally, and exploring the Software Catalog
- •What is Backstage?
- •02 local backstage setup labLab
- •Project Structure and Configuration
- •Plugins, Build, and Development
- •Entity Types - Components, APIs, and Systems
- •Entity Types - Users, Groups, and Resources
- •Catalog Organization and Discovery
- •08 basic catalog labLab
- •Day 1: Getting Started with BackstageQuiz
SECTION 2 – TEMPLATES, DOCUMENTATION, AND AUTOMATION
Building Software Templates with the Scaffolder, implementing TechDocs for documentation-as-code, and configuring automated discovery
- •Software Templates Fundamentals
- •Template Actions and Skeleton Content
- •Template Integration and Best Practices
- •04 templates labLab
- •Advanced Scaffolder Patterns
- •TechDocs and MkDocs Fundamentals
- •TechDocs Integration and Publishing
- •08 techdocs labLab
- •09 discovery labLab
- •Day 2: Templates and DocumentationQuiz
SECTION 3 – DOCKER AND POSTGRESQL DEPLOYMENT
Moving from local development to Docker deployment with PostgreSQL and production security using Docker secrets
- •Docker Deployment & PostgreSQL
- •Docker Security & Production Deployment
- •03 docker labLab
- •Day 3: Docker and DatabaseQuiz
SECTION 4 – AUTHENTICATION AND AUTHORIZATION
OIDC authentication with Keycloak and role-based access control using the permissions framework
- •OIDC Authentication with Keycloak
- •02 keycloak integration labLab
- •Role-Based Access Control with Permissions
- •04 permissions labLab
- •Day 4: Authentication and PermissionsQuiz
SECTION 5 – KUBERNETES DEPLOYMENT
Deploy PostgreSQL and Backstage to Kubernetes using raw manifests following the official guide, build custom Docker images, and access applications using port-forwarding
- •Kubernetes Fundamentals and Building Images
- •Deploying to Kubernetes with Manifests
- •03 kubernetes deployment labLab
- •Kubernetes Deployment and OrchestrationQuiz
SECTION 6 – KUBERNETES INTEGRATION
Configure the Kubernetes plugin to provide developers with visibility into their workloads across multiple clusters
- •Kubernetes Plugin Overview
- •Kubernetes Plugin Configuration
- •03 kubernetes plugin labLab
- •Kubernetes Integration Knowledge CheckQuiz
SECTION 7 – PLUGINS AND PRODUCTION GITOPS
Plugin development fundamentals, GitOps deployment patterns with ArgoCD, and building production-grade developer portals with complete CI/CD workflows
- •Plugin Development Fundamentals
- •02 simple plugin labLab
- •Production GitOps and Platform Engineering Patterns
- •Final Assessment: Plugins and Production GitOpsQuiz
SECTION 8 – COURSE WRAP-UP
Celebrate your achievements, review what you've learned, and discover next steps in your platform engineering journey
- •Congratulations and Next Steps
Course Features
Hands-on Labs
Lots of hands-on labs to learn by doing
Join our Community
Community support to ask questions and collaborate
Test Your Knowledge
Quizzes to help you grasp the material well
See what others are saying about our Courses
“Dear Sam, I hope this email finds you well. If you remember before the end of last year I register for one your courses Terraform 101 – Certified Terraform Associate, I must admit that I learned a lot even though I was not patient enough for all videos to be available. All in all I enjoy the way you structured the course and how you went through it. The main reason of this email, to send you my gratitude for the content you created and to let you know that I passed my exam/test last week.”
“This course was a perfect introduction to Terraform and Infrastructure as Code. Loved the gitpod, saving me a lot of time for developer environment setup. We have a project at work where we want to go from a click-ops version of server-deploy to a more automated flow using ci/cd and terraform for deploying virtual servers.”
“I want to thank you for such wonderful courses. They are more comprehensive than other courses I have taken in the past. You take the time to explain every detail of the code and what it does exactly, further enforcing your student's understanding and confidence in what they are learning. Your methods are very effective and set you apart from other instructors.”
Choose your plan
Simple, Transparent Pricing
One price, everything included
Everything Included in Your Subscription
Content & Learning
- Access to all courses and bootcamps
- Video lessons with closed captions
- Interactive quizzes and assessments
- Course completion certificates
Hands-On Labs
- Browser-based cloud labs
- Pre-configured VMs ready to use
- Playgrounds for experiments
- Multi-VM realistic scenarios
AWS Integration
- Managed AWS Account included
- Pre-configured environments
- Real-world cloud scenarios
Support & Community
- Priority support
- Active community forum
No Setup Required
- Everything runs in your browser
- No software installation needed
- Automatic environment provisioning
- Works on any device
Hi there, I'm Sam
I'm a husband and father of two wonderful boys. I'm also very passionate 🔥 about all things technology. From when I was 10, I had a dream to become a computer 💻 engineer one day. Here I am today living the dream!
Thanks for visiting TeKanAid Academy. My goal is to teach you all things DevOps. Below are some of the things I've done over the years. I'm confident that I can help you achieve your dreams too.
- 15+ years of experience in various Information Technology fields from Telecommunications, Computer Networks, Digital Transformation, DevOps, Cybersecurity, and IoT
- President of TeKanAid Solutions Inc. building online content in the DevOps space
- Previous – Sr. Solutions Engineer at HashiCorp
View my Certifications
Terraform: Authorized HashiCorp Instructor
Verify my certificate
HashiCorp Authorized Instructors are experienced DevOps professionals who deliver official HashiCorp training courses in person and virtually.
Issued by HashiCorp Partner Network (HPN)
Vault: Authorized HashiCorp Instructor
Verify my certificate
HashiCorp Authorized Instructors are experienced DevOps professionals who deliver official HashiCorp training courses in person and virtually.
Issued by HashiCorp Partner Network (HPN)
HashiCorp Certified: Terraform Associate (002)
Verify my certificate
Earners of the HashiCorp Certified: Terraform Associate certification know the basic concepts, skills, and use cases associated with open source HashiCorp Terraform.
Issued by HashiCorp
HashiCorp Certified: Vault Associate (002)
Verify my certificate
Earners of the HashiCorp Certified: Vault Associate certification know the basic concepts, skills, and use cases associated with open source HashiCorp Vault.
Issued by HashiCorp
Featured Products
Crossplane 101: Platform Engineering with Cloud-Native Infrastructure as Code
Build Internal Developer Platforms with Crossplane that enable self-service AWS infrastructure provisioning through Kubernetes APIs
Learn More →
HashiCorp Sentinel 101
Master HashiCorp Sentinel for policy as code, governance, and compliance in Terraform workflows.
Learn More →
Terraform 101 – Certified Terraform Associate
Master Terraform from basics to advanced concepts with hands-on labs, prepare for certification, and learn Infrastructure as Code best practices.
Learn More →
30-Day Money-Back Guarantee
Try it risk-free
I'm confident you'll get everything you need from this course and be 100% satisfied. But in the unlikely event you decide it's not for you just ask for a refund any time during the first 30 days and you'll get your money back with no questions asked.