Migrating from 2.x to 1.x

⚠️

If you installed PC2 before February 2026, you’re on version 2.6.x. You need to manually update once to get on the new release track.

Why Manual Update?

We reset our versioning for the public launch:

Old versions: 2.6.0 → 2.6.8 (pre-release/beta)
New versions: 0.1.1 → 1.0.0+ (public release)

Your PC2 thinks 2.6.x is “newer” than 0.1.1, so auto-update won’t kick in. This is a one-time fix - after this, auto-updates work normally.

How to Update

Stop PC2

pm2 stop pc2

Update the code

cd ~/pc2.net
git fetch origin main
git reset --hard origin/main

Reinstall dependencies

npm install --legacy-peer-deps --ignore-scripts

Rebuild

cd pc2-node && npm run build

Restart PC2

pm2 restart pc2

Verify

Open your PC2 in browser and go to Settings → About. You should see version 0.1.1 or higher.

Quick One-Liner

If you prefer, run this single command:

pm2 stop pc2 && cd ~/pc2.net && git fetch origin main && git reset --hard origin/main && npm install --legacy-peer-deps --ignore-scripts && cd pc2-node && npm run build && pm2 restart pc2

After Migration

Once you’re on 0.1.1+, auto-updates work normally:

Go to Settings → About → Check for Updates
Or wait for the update notification

Your files and data are preserved during this update. Only the application code changes.

Troubleshooting

”Permission denied” errors

sudo chown -R $USER:$USER ~/pc2.net

Build fails

rm -rf node_modules
npm install --legacy-peer-deps --ignore-scripts
cd pc2-node && npm run build

PM2 not found

source ~/.nvm/nvm.sh

Access Control AI Setup