Updating Guide

Learn how to update your Appy installation to the latest version. The update process is straightforward and takes only a few minutes.

Before You Update

Before updating Appy, make sure to backup your important data to prevent any data loss:

Important: Always create backups before updating. While updates are generally safe, having backups ensures you can restore your data if anything goes wrong.

Backup Checklist

Backup Your Database

Export your database using phpMyAdmin, MySQL Workbench, or command line:

# MySQL backup
mysqldump -u username -p database_name > backup_$(date +%Y%m%d).sql

# Or if using SQLite, copy the database file
cp database/database.sqlite database/database_backup.sqlite

Backup Your .env File

Download or copy your .env file to a safe location. This file contains your database credentials, API keys, and other configuration settings.

Backup User Uploads

Download the storage/app folder which contains user-uploaded files like app icons, splashscreens, and keystores.

Updating the Laravel Application

Follow these steps to update your Appy installation via FTP:

Download the Latest Version

Download the latest version from CodeCanyon. You will receive a ZIP file containing the updated files.

Extract and Locate the Install Folder

Extract the ZIP file and locate the Install/ folder. This contains the updated Laravel application files.

CodeCanyon-Download/
├── Documentation/
├── Install/          ← Upload this folder's contents
│   ├── app/
│   ├── config/
│   ├── database/
│   ├── public/
│   ├── resources/
│   ├── routes/
│   ├── storage/
│   ├── vendor/
│   ├── .env          ← Do NOT upload this (keep your existing .env)
│   └── ...
└── Builder/

Upload Files via FTP

Connect to your server via FTP and upload all files from the Install/ folder to your public_html folder (or wherever Appy is installed). Overwrite existing files when prompted.

Do NOT upload these files:

.env - Keep your existing .env file (do NOT overwrite)
database/database.sqlite - Keep your existing database (if using SQLite)

Verify File Permissions

After uploading, ensure the following directories are writable:

storage/ - Should be 775
bootstrap/cache/ - Should be 775

Updating the App Builder

If you're running a custom builder server (not using the default hosted builder), you'll also need to update the builder binary:

Note: If you're using the Default Free Builder hosted by Titan Systems, you can skip this section. The hosted builder is automatically updated.

Stop the Builder

Stop the running builder process:

pm2 stop all

Locate the Prebuilt Folder

In the CodeCanyon download, find the Builder/prebuilt/ folder:

Builder/
└── prebuilt/           ← Upload this folder's contents
    ├── appy-builder-linux
    ├── appy-builder-arm64
    ├── appy-builder-macos
    ├── templates/
    └── storage/

Upload and Replace Files

Upload all files from Builder/prebuilt/ to your builder server directory (usually /opt/appy-builder/ or /home/appy-builder/). Replace existing files when prompted.

# Make the new binary executable
chmod +x appy-builder-linux

Restart the Builder

Start the builder again:

pm2 restart all

Post-Update Steps

After uploading the files, complete these steps to finalize the update:

Run the Web Upgrade

Visit /upgrade in your browser to run database migrations and clear caches automatically:

https://yourdomain.com/upgrade

This page will automatically detect pending migrations and run them for you. Once complete, you'll be redirected to the dashboard.

Note: If there are no pending migrations, the /upgrade page will return a 404 error. This means your database is already up to date.

Verify the Update

Admin panel loads without errors
User apps are still visible
Test a new build to confirm the builder is working

Done! Your Appy installation is now updated to the latest version.

For Advanced Users (Terminal)

If you have SSH access and prefer to run commands manually:

# Run database migrations
php artisan migrate --force

# Clear all caches
php artisan optimize:clear

Version Notes

Check the changelog for version-specific update instructions and new features:

Latest Updates

For the latest changelog and version-specific notes, please refer to the changelog included in your CodeCanyon download or visit our support portal.

View Changelog

Previous VPS Auto Setup Next Admin Settings