Recommended Migration for Self-Hosted Servers from FE1 to FE2

We recommend an important update for those of you who are self-hosting Speckle servers. To enhance performance and reliability, migrate your current FE1 servers to the new FE2 servers.

The visual changes can be seen between speckle.xyz (legacy) and app.speckle.systems (new), both pointing to the same underlying data.

Benefits of Migrating:

  • Improved Performance: The new web app offers better processing power and speed, ensuring a smoother user experience.
  • Increased Reliability: The new web app is on a new development release cycle with at least weekly updates, yielding more robust, enhanced uptime and stability.
  • Legacy app development: The Development of the legacy web app has stopped. The new UI and APIs will exclusively improve Speckle.

Migration Steps:

  1. This is simply a UI package change, all your data stays intact, untouched.
  2. Nevertheless, normal best practices apply with respect to backups
  3. Possibly nothing. Updating to latest release will automatically switch the web app.
  4. If you have explicitly flagged FE2 as disabled you simply remove the flag in helm-release.yaml.
    #frontend_2:
    #  enabled: false
    
  5. Our Docker-compose documentation is already up-to-date: Deploying a Server - Docker Compose | Speckle Docs

Key Notes:

  • Globals: Temporarily unavailable but will be accessible via API.
  • Audit Stream: Temporarily unavailable but will be accessible via API.
  • Embedded Viewers: We have included routing to mean older URL links will map to the new URL structure; note that custom cameras and data filters are not yet supported.
  • GraphQL Endpoints: No immediate action, but start a migration plan from FE1 language queries and mutations, which will be deprecated later this year. Our SDKs are already moving this way.

We strongly encourage you to undertake this migration to take advantage of the new web app experience’s improved capabilities. Thank you for your cooperation and continued support.

3 Likes