VPS Auto Setup Guide

Deploy Appy on a fresh Ubuntu 24.04 VPS with a single command. This automated script installs everything you need, including the builder server.

Prerequisites

Before running the auto-setup script, ensure you have the following:

What Gets Installed

The auto-setup script installs and configures everything needed to run Appy and build Android apps:

The script also automatically:

• Creates secure database credentials
• Generates an admin account with a secure password
• Configures the builder server with PM2
• Registers the builder in the database
• Sets up UFW firewall
• Enables automatic SSL renewal

Step 1: Upload Files via SFTP

Upload the entire contents of your CodeCanyon ZIP package to /home/ on your VPS.

/home/
├── Documentation/        (optional - for reference)
├── Install/              (Laravel app + setup script)
│   ├── app/
│   ├── config/
│   ├── database/
│   ├── public/
│   ├── resources/
│   ├── routes/
│   ├── storage/
│   ├── vendor/
│   ├── autosetup.sh      ← Setup script
│   └── ...               (other Laravel files)
└── Builder/              (Builder server)
    └── prebuilt/
        ├── appy-builder-linux
        ├── templates/
        └── storage/

Step 2: Connect via SSH

Connect to your VPS using SSH with root access:

ssh root@your-server-ip

Example:

ssh [email protected]

Step 3: Run the Setup Script

Run the setup script from your SSH terminal (you'll typically be in /root/ after logging in):

bash /home/Install/autosetup.sh

The script will prompt you for:

1. Domain Name - Your domain (e.g., example.com or app.example.com)
2. Purchase Code - Your CodeCanyon purchase code (optional, can be set later)

Script Execution

After confirming, the script will begin installing components. This process takes approximately 10-15 minutes. You'll see progress updates for each step:

[INFO] Updating package repositories...
[SUCCESS] System packages updated successfully

[INFO] Installing PHP 8.4 and extensions...
[SUCCESS] PHP installed: PHP 8.4.x

[INFO] Installing MySQL 8.0...
[SUCCESS] MySQL 8.0 installed and secured

... and so on

Step 4: Configure DNS

During the SSL certificate step, the script will pause and display your server's IP address. You need to configure your DNS before continuing.

Post-Installation

When the script completes, it displays all your credentials. Save these immediately!

═══════════════════════════════════════════════════════════════════
  APPY INSTALLATION COMPLETED!
═══════════════════════════════════════════════════════════════════

ACCESS YOUR PLATFORM:
  Website: https://yourdomain.com

ADMIN LOGIN:
  URL: https://yourdomain.com/login
  Email: [email protected]
  Password: [auto-generated]

DATABASE CREDENTIALS:
  Host: localhost
  Database: appy
  Username: appy_xxxx
  Password: [auto-generated]
  MySQL Root: [auto-generated]

DATABASE MANAGER:
  Adminer: https://yourdomain.com/adminer
  System: MySQL
  Server: localhost
  Username: appy_xxxx
  Password: [auto-generated]

BUILDER SERVER:
  URL: http://127.0.0.1:8080
  Server Key: [auto-generated]

Verify Installation

The script automatically verifies all services are running. You can also manually check:

# Check web services
systemctl status nginx
systemctl status php8.4-fpm
systemctl status mysql

# Check builder server
pm2 status

# Check SSL certificate
sudo certbot certificates

Useful Commands

Adminer Database Manager

Adminer is a lightweight database management tool that comes pre-installed. It provides a web interface for managing your MySQL database.

Accessing Adminer

Navigate to https://yourdomain.com/adminer in your browser. You'll be prompted to login with your database credentials:

• System: MySQL
• Server: localhost
• Username: Your generated database username (e.g., appy_xxxx)
• Password: Your generated database password
• Database: appy (leave blank to see all databases)

Removing Adminer

If you don't need Adminer or want to remove it for security:

sudo rm /var/www/html/adminer.php

After deletion, the /adminer URL will return a 404 error.

Alternative Database Management

You can also manage your database via SSH:

# Connect to MySQL as root
mysql -u root -p

# Or use Laravel's tinker from your app directory
cd /home/appy
php artisan tinker

Troubleshooting

SSL Certificate Failed

If SSL certificate generation fails:

1. Verify your domain DNS is pointing to the server IP
2. Wait a few more minutes for DNS propagation
3. Run certbot manually: sudo certbot --nginx -d yourdomain.com

Builder Not Starting

If the builder fails to start:

# Check logs for errors
pm2 logs appy-builder --lines 50

# Ensure environment is loaded
source /etc/profile.d/java.sh
source /etc/profile.d/android.sh

# Restart the builder
cd /home/appy-builder
pm2 restart all

Permission Errors

If you encounter permission errors:

# Reset Laravel permissions
cd /home/appy
chown -R www-data:www-data .
chmod -R 755 .
chmod -R 775 storage bootstrap/cache

Database Connection Failed

If Laravel can't connect to the database:

# Check MySQL is running
systemctl status mysql

# Verify credentials in .env file
cat /home/appy/.env | grep DB_

# Test connection
mysql -u [username] -p[password] [database]

Viewing Logs

For detailed troubleshooting, check these log files:

# Installation log
cat /home/install.log

# Laravel logs
tail -f /home/appy/storage/logs/laravel.log

# Nginx error logs
tail -f /var/log/nginx/error.log

# Builder logs
pm2 logs appy-builder