Updating

Keep your Plainpad installation up to date to benefit from new features, security patches, and bug fixes.

Before You Update

Important: Always back up your database and application files before performing an update.

Create a Backup

# Back up the database (MySQL)
mysqldump -u username -p plainpad_db > plainpad_backup.sql

# Back up application files
cp -r /var/www/html/plainpad /var/www/html/plainpad_backup

Update Process

Updating Plainpad is a simple file replacement process:

Step 1: Download the Latest Version

Download the latest release from the GitHub releases page.

Step 2: Replace Files

Replace the existing application files with the new ones. Make sure to preserve your configuration files:

# Extract the new version
tar -xzf plainpad-latest.tar.gz

# Replace files (preserving config)
rsync -av --exclude='config.php' plainpad-new/ /var/www/html/plainpad/

Step 3: Run Migrations

Plainpad will automatically detect that a new version has been installed and will run any necessary database migrations when you access the application in your browser.

Step 4: Clear Cache

After updating, clear your browser cache or perform a hard refresh (Ctrl + Shift + R) to ensure you're loading the latest frontend assets.

Verifying the Update

After updating, verify that everything is working correctly:

  • Log in to your Plainpad account
  • Check that existing notes are accessible
  • Test creating and editing a note
  • Verify the version number in the settings panel

Rollback: If something goes wrong, restore your backup files and database to return to the previous version.