From e012e6ed9c05d72d577282061316eb7c5de6bc9e Mon Sep 17 00:00:00 2001
From: jae beller <jae@fly.io>
Date: Mon, 16 Mar 2026 17:48:15 -0400
Subject: [PATCH 1/2] Add instructions to upgrade the Sprite OS

---
 src/content/docs/sprite-maintenance.mdx | 44 +++++++++++++++++++++++++
 src/lib/sidebar.ts                      |  1 +
 2 files changed, 45 insertions(+)
 create mode 100644 src/content/docs/sprite-maintenance.mdx

diff --git a/src/content/docs/sprite-maintenance.mdx b/src/content/docs/sprite-maintenance.mdx
new file mode 100644
index 0000000..86e61f7
--- /dev/null
+++ b/src/content/docs/sprite-maintenance.mdx
@@ -0,0 +1,44 @@
+---
+title: Sprite Maintenance
+description: Keeping your Sprites happy and healthy
+---
+
+import { Callout, StatusIcon } from '@/components/react';
+
+Sprites are persistent. Everything you leave is there when you come back, including the software. Long-living Sprites still need regular updates. This guide walks through some of the common tasks for maintenance the software environment in your Sprite.
+
+---
+
+## OS Upgrades
+
+New Sprites run on a fresh install of Ubuntu 25.10. Older Sprites created with Ubuntu 25.04 must upgrade to continue receiving security and feature updates.
+
+<Callout type="info">
+If you don't know what version of Ubuntu your Sprite currently runs, check with:
+
+```bash
+lsb_release -d
+```
+</Callout>
+
+Fortunately, Sprites are disposable. If your workload doesn't require the Sprite to live long-term, upgrading is easy: destroy the Sprite and create a new one! If you need to copy files over, try [mounting the filesystem locally](/working-with-sprites/#mounting-filesystem-locally).
+
+If creating a new Sprite is impractical, you can also upgrade Ubuntu in-place. Keep in mind that bundled software (such as agents and language toolchains) must be upgraded separately. Install the Ubuntu upgrader with:
+
+```bash
+sudo apt update
+sudo apt install ubuntu-release-upgrader-core
+```
+
+With the upgrader installed, follow the [official instructions](https://ubuntu.com/server/docs/how-to/software/upgrade-your-release/) from Ubuntu. In short:
+
+```bash
+# upgrade to the latest packages for the current release
+sudo apt upgrade
+
+# switch to the new release
+sudo do-release-upgrade
+
+# upgrade installed packages to the new release
+sudo apt upgrade
+```
diff --git a/src/lib/sidebar.ts b/src/lib/sidebar.ts
index ca950da..e3cdba4 100644
--- a/src/lib/sidebar.ts
+++ b/src/lib/sidebar.ts
@@ -108,6 +108,7 @@ export const sidebarConfig: SidebarGroup[] = [
       { label: 'Overview', slug: 'index' },
       { label: 'Quickstart', slug: 'quickstart' },
       { label: 'Working with Sprites', slug: 'working-with-sprites' },
+      { label: 'Sprite Maintenance', slug: 'sprite-maintenance' },
     ],
   },
   {

From 26de009157f7c63a213c52d4d914670ac289b03c Mon Sep 17 00:00:00 2001
From: Kristin Martin <kcmartin@users.noreply.github.com>
Date: Wed, 18 Mar 2026 11:27:16 -0700
Subject: [PATCH 2/2] Update src/content/docs/sprite-maintenance.mdx

---
 src/content/docs/sprite-maintenance.mdx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/content/docs/sprite-maintenance.mdx b/src/content/docs/sprite-maintenance.mdx
index 86e61f7..2439bb9 100644
--- a/src/content/docs/sprite-maintenance.mdx
+++ b/src/content/docs/sprite-maintenance.mdx
@@ -5,7 +5,7 @@ description: Keeping your Sprites happy and healthy
 
 import { Callout, StatusIcon } from '@/components/react';
 
-Sprites are persistent. Everything you leave is there when you come back, including the software. Long-living Sprites still need regular updates. This guide walks through some of the common tasks for maintenance the software environment in your Sprite.
+Sprites are persistent. Everything you leave is there when you come back, including the software. Long-living Sprites still need regular updates. This guide walks through some of the common tasks for maintaining the software environment in your Sprite.
 
 ---