ESC
Getting Started

Installation

Server Requirements

Before installing FreshStay, make sure your server meets these requirements:

Requirement Minimum
PHP 8.2 or higher
MySQL 8.0 or higher
Composer 2.0 or higher
Node.js 18+ (for asset compilation)
PHP Extensions BCMath, Ctype, JSON, Mbstring, OpenSSL, PDO, XML, Curl, Zip, GD
Memory Limit 256MB minimum
**Recommended:** Use a VPS with at least 1GB RAM, Nginx, and PHP-FPM for the best performance.

Installation Wizard

FreshStay includes a built-in installation wizard that guides you step by step.

1

Upload Files

Upload the FreshStay files to your server root (e.g. `/var/www/html`).

2

Open Installer

Navigate to `yourdomain.com` in your browser. The installer starts automatically.

3

Enter Purchase Code

Enter your Envato purchase code. It verifies via our server to activate your license.

4

Database Setup

Enter database credentials. Use "Test Connection" to verify before proceeding.

5

Admin Account

Create your admin account and set site name, timezone, and default currency.

6

Complete!

Installer runs migrations, seeds data, and optimizes. You'll be redirected to admin.

**Important:** A valid Envato purchase code is required. The application will not install without one.

Manual Installation

For advanced users who prefer command-line setup:

BASH
# Navigate to project directory
cd /var/www/html/freshstay

# Install PHP dependencies
composer install --no-dev --optimize-autoloader

# Copy environment file
cp .env.example .env

# Generate application key
php artisan key:generate

# Run database migrations with seed data
php artisan migrate --seed

# Create storage symlink
php artisan storage:link

# Optimize for production
php artisan optimize
**Tip:** Add your `FRESHSTAY_LICENSE_KEY` and `FRESHSTAY_PURCHASE_CODE` to the `.env` file for license verification.

File Permissions

Ensure these directories are writable by the web server:

BASH
chmod -R 775 storage bootstrap/cache
chown -R www-data:www-data storage bootstrap/cache

Was this page helpful?

Next
Configuration