# Updating Guide

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

#### On this page

- Before You Update
- Updating the Laravel Application
- Updating the App Builder
- Post-Update Steps
- Version Notes

## 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

1

#### 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

2

#### 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.

3

#### 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:

1

#### Download the Latest Version

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

2

#### 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/

3

#### 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)

4

#### 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.

1

#### Stop the Builder

Stop the running builder process:

    pm2 stop all

2

#### 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/

3

#### 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

4

#### Restart the Builder

Start the builder again:

    pm2 restart all

## Post-Update Steps

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

1

#### 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.

2

#### Verify the Update

Log in to your Appy dashboard and verify everything is working correctly. Check:

- 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

© 2026 Titan Systems. All Rights Reserved.