Migration Overview and Decision Guide
Review the Legacy Federation sunset timeline and confirm readiness before migrating to RTFS.
JFrog is officially sunsetting Legacy Repository Federation as the platform transitions to the next-generation Artifactory Federation Service (RTFS). This guide helps you understand the timeline, evaluate readiness, and plan your migration if you have a self-managed environment.
Note
This sunset applies to self-managed environments only.
Sunset Timeline
The following table outlines the sunset timeline.
| Milestone | Date | Details |
|---|---|---|
| Official announcement | January 2026 | Declaration of the sunset plan |
| Migration window | Now through mid-2027 | 18-month period during which you're asked to migrate to RTFS |
| Deprecation | July 2027 | Removal of Legacy Federation from the codebase of new releases |
Older releases will continue to be supported based on JFrog standard support policies.
Why Migrate to RTFS
The Artifactory Federation Service represents the next generation of repository federation with:
- Superior standalone microservice architecture designed to reduce impact on Artifactory
- All new features, including Unidirectional Sync, are being developed exclusively for RTFS
- Already the default for all JFrog SaaS customers
- Validated by leading enterprise customers with improved stability and performance
Migration Readiness Checklist
Before migrating, confirm the following:
- PostgreSQL database available: The RTFS service requires a PostgreSQL database connection. If your Artifactory uses a different database, you only need a separate PostgreSQL instance for RTFS. You don't need to migrate your entire Artifactory installation.
- Artifactory version: You are running Artifactory 7.104.5 or later (RTFS was introduced in this release).
- Certificate support: If using self-signed certificates or certificates signed by a custom CA, you must be running Artifactory 7.133.4 or later. Versions earlier than 7.133.x require certificates signed by a trusted CA. For Kubernetes/Helm deployments using custom or self-signed CAs, ensure the RTFS trust store includes those certificates (for example, through platform trusted-certificate configuration for your chart). Confirm the exact keys and values for your chart version before deploying.
- No Full Sync in progress: Verify that no Full Sync operations are running before starting migration.
- RTFS service activated: The Artifactory Federation Service must be installed and activated before migration.
Migration Support
The migration from Legacy Federation to RTFS is designed to be seamless:
- Automatic migration tools ensure configuration and data integrity
- No downtime required during migration
- Hybrid Mode allows RTFS and Legacy Federation to coexist during transition
- Full rollback capabilities during the transition window
- You don't need to migrate all sites simultaneously
Next Steps
Frequently Asked Questions
This section provides answers to frequently asked questions.
FAQs
Q: When is Legacy Federation being deprecated?
A: Legacy Federation is removed from the codebase of new releases starting July 2027. The migration window runs from now through mid-2027. See Sunset Timeline for the full schedule.
Q: Do I need to migrate all my sites to RTFS at once?
A: No. You don't need to migrate all sites simultaneously — Hybrid Mode lets RTFS and Legacy Federation coexist across sites during the transition.
Q: What's required before I can migrate to RTFS?
A: You need a PostgreSQL database connection, Artifactory 7.104.5 or later, no Full Sync operations in progress, and the Artifactory Federation Service installed and activated. See Migration Readiness Checklist for the full list.
Q: Is there downtime when migrating to RTFS?
A: No. The migration is designed to require no downtime, and automatic migration tools ensure configuration and data integrity throughout the process.
Q: Can I roll back if the migration doesn't complete as expected?
A: Yes. Full rollback capabilities are available during the transition window. See Migration Rollback for the procedure.
Related Topics
Updated about 7 hours ago