# Migrating legacy services to a modern developer portal: A technical guide to Backstage integration

DevFeed: [Migrating legacy services to a modern developer portal: A technical guide to Backstage integration](<https://devfeed.tech/articles/migrating-legacy-services-to-a-modern-developer-portal-a-technical-guide-to-backstage-integration-12111.md>)

Original publisher: [Read original article](<https://backstage.io/blog/2025/08/08/migrating-legacy-services-to-a-modern-developer-portal>)

Author: Damola Obaleke, The New York Times

Published: 2025-08-08T00:00:00Z

Content type: article

Language: en

Sources: [Backstage Software Catalog and Developer Platform Blog](<https://devfeed.tech/sources/backstage-software-catalog-and-developer-platform-blog.md>)

Topics: [Backstage](<https://devfeed.tech/topics/backstage.md>), [internal developer portal](<https://devfeed.tech/topics/internal-developer-portal.md>), [Developer experience](<https://devfeed.tech/topics/developer-experience.md>), [Script](<https://devfeed.tech/topics/script.md>)

Tags: [backstage](<https://devfeed.tech/tags/backstage.md>), [catalog](<https://devfeed.tech/tags/catalog.md>), [developer](<https://devfeed.tech/tags/developer.md>), [developer-experience](<https://devfeed.tech/tags/developer-experience.md>), [developer-portal](<https://devfeed.tech/tags/developer-portal.md>), [development](<https://devfeed.tech/tags/development.md>), [github](<https://devfeed.tech/tags/github.md>), [guide](<https://devfeed.tech/tags/guide.md>), [idp](<https://devfeed.tech/tags/idp.md>), [integration](<https://devfeed.tech/tags/integration.md>), [internal-developer-platform](<https://devfeed.tech/tags/internal-developer-platform.md>), [internal-developer-portal](<https://devfeed.tech/tags/internal-developer-portal.md>), [open-source](<https://devfeed.tech/tags/open-source.md>), [platform-engineering](<https://devfeed.tech/tags/platform-engineering.md>), [software](<https://devfeed.tech/tags/software.md>), [software-catalog](<https://devfeed.tech/tags/software-catalog.md>), [software-development](<https://devfeed.tech/tags/software-development.md>), [software-templates](<https://devfeed.tech/tags/software-templates.md>), [techdocs](<https://devfeed.tech/tags/techdocs.md>), [technical](<https://devfeed.tech/tags/technical.md>)

## AI overview

This technical guide describes migrating a legacy internal service catalogue to the Backstage Software Catalog. It covers automated scripts for transforming and ingesting service definitions, adoption strategies, and cultural and technical challenges when introducing a modern internal developer portal.

## Source excerpt

TL;DR: As part of our efforts to streamline service management and improve developer experience, our engineering org migrated from a legacy service catalogue to the Backstage Software Catalog. In this post, I'll share what we learned from that journey --- including how to build an automated script to migrate services from an existing internal service catalogue to a modern internal developer portal (IDP) like Backstage. I'll also outline strategies to help drive adoption across your organization, along with tips for addressing both the cultural and technical roadblocks you might encounter along the way.