https://pockethost.io/_app/immutable/chunks/2g2WwlSG2.js

1import{B as e,R as t,St as n,kt as r}from"./CzsObDY8.js";import"./xihTtKlq.js";import"./C5qy-xbg.js";var i=r({default:()=>l,metadata:()=>a}),a={title:`Changing PocketBase Versions`,description:`Learn how to upgrade and downgrade your Pocketbase version in Pockethost`},{title:o,description:s}=a,c=e(`<h1>Changing PocketBase Versions</h1> <p>PocketHost supports the latest minor release of each PocketBase version (e.g., <code>0.16.*</code>), and you can update your instance to stay on the latest release. When changing PocketBase versions, whether upgrading or downgrading, it’s important to take precautions to ensure the stability of your instance and the integrity of your data.</p> <h2>Upgrade Strategy</h2> <p>Upgrading your instance to the latest version of PocketBase is straightforward but requires careful planning to avoid data loss or unexpected behavior. Here’s the recommended approach:</p> <ol><li><a href="/docs/backup-restore">Back up your instance</a> to ensure your data is safe.<br/> <img src="/generated/docs/versions/2024-10-06-15-31-47.png"/></li> <li><strong>Create a second instance</strong>: We recommend creating a second PocketHost instance and restoring your backup to it. This allows you to test the upgrade without affecting your live instance.</li> <li>Perform the upgrade on the second instance, ensuring all functionality is intact and working as expected.<br/> <img src="/generated/docs/versions/version-change.png"/></li> <li>Once you are confident that everything works correctly, upgrade your main instance.</li> <li><a href="/docs/power">Power off your instance</a> to make it live again after the upgrade.</li></ol> <h2>Automatic Upgrade Steps</h2> <p>For most cases, automatic upgrades are possible by simply switching to the latest version:</p> <ol><li><a href="/docs/backup-restore">Back up your instance</a>.<br/> <img src="/generated/docs/versions/2024-10-06-15-31-47.png"/></li> <li>Change to the latest supported version in the PocketHost dashboard (e.g., <code>0.16.*</code>).<br/> <img src="/generated/docs/versions/version-change.png"/></li> <li><a href="/docs/power">Power off your instance</a> and restart it to apply the changes.</li></ol> <h2>Manual Upgrade Steps (Rare Cases)</h2> <p>If the automatic upgrade results in an unresponsive instance due to database schema issues, a manual upgrade is required:</p> <ol><li><a href="/docs/backup-restore">Back up your instance</a> via the PocketBase admin.</li> <li>Download your database backup from the PocketBase admin.</li> <li>On your local machine, follow the necessary upgrade steps according to the <a href="https://pocketbase.io/docs/" rel="nofollow">PocketBase documentation</a>.</li> <li>Perform a backup locally after completing the upgrade.</li> <li><a href="/docs/backup-restore">Restore</a> the upgraded backup via the live PocketBase admin.</li></ol> <h2>Important Notes</h2> <h3>Downgrading Versions</h3> <p><strong>Be cautious when downgrading</strong> – PocketBase does not officially support downgrades. While downgrades may work in some cases, there is no guarantee they will succeed without causing issues. If you attempt to downgrade and run into problems, there is no official resolution path.</p> <h3>Testing Before Upgrading</h3> <p>

1To avoid potential disruptions, always create a second instance, restore your backup to it, and test the upgrade there first. This practice ensures you can catch any issues before applying changes to your live instance.</p> <h3>System Table Migrations</h3> <p>When you upgrade to a new version, PocketBase may perform automatic migrations on system tables. These migrations are typically non-destructive, but you should proceed with caution and ensure you have a backup before applying any updates.</p>`,1);function l(e){var r=c();n(34),t(e,r)}export{l as n,i as t};