Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.breezehost.xyz/llms.txt

Use this file to discover all available pages before exploring further.

Deploying Your Website

Multiple options exist for getting your website onto Breeze Hosting. Choose the method that matches your project type.

Quick Deployment Comparison

Static HTML

Perfect for portfolios, landing pages, and documentation sites

WordPress

Blog platform — one-click install through Plesk

Node.js

Modern JavaScript applications and APIs

PHP Applications

Traditional web apps, Laravel, Symfony, Drupal

Git Deployment

Deploy directly from GitHub or GitLab

FTP Upload

Simple drag-and-drop file uploads

Static Website (HTML/CSS/JavaScript)

Perfect for portfolios, landing pages, and documentation.

Using File Manager

1

Prepare Your Files

Have your HTML, CSS, and JavaScript files ready on your computer
2

Open File Manager

In Plesk, go to Websites & Domains → Your Domain → File Manager
3

Navigate to httpdocs

You should be in the /httpdocs folder (your website root)
4

Delete Default Files

Remove index.html or any default files from Plesk (optional)
5

Upload Your Files

Drag and drop your files into the File Manager or click “Upload”
6

Create Folder Structure

Create folders for css, images, js, etc. as needed
7

Test Your Site

Visit https://your-domain.com in your browser

Using FTP/SFTP

For larger projects, use FTP/SFTP for faster uploads: FTP Credentials:
  • Server: ftp.your-domain.com or your server IP
  • Username: Your Plesk username or FTP account
  • Password: Your Plesk password
  • Port: 21 (FTP) or 22 (SFTP)
Recommended FTP Clients:
  • FileZilla (free, all platforms)
  • Cyberduck (Mac/Windows)
  • WinSCP (Windows only)
  • Transmit (Mac)
Using FileZilla:
  1. Install FileZilla
  2. File → Site Manager → New Site
  3. Enter server, username, password
  4. Connect
  5. Navigate to /httpdocs on remote side
  6. Drag files from local to remote
  7. Right-click → Permissions to set as needed
Use SFTP instead of FTP for security. FTP sends passwords in plain text. SFTP encrypts the connection.

WordPress Installation

Install WordPress with one click through Plesk, or manually:
1

Open Plesk Applications

In Plesk, click “Applications” or “App Installer”
2

Find WordPress

Search for “WordPress” and click it
3

Click Install

Click “Install” next to the WordPress version
4

Choose Domain

Select which domain to install WordPress on
5

Configure Installation

  • Admin Email: Your admin email
  • Admin Username: Secure username (not admin)
  • Admin Password: Strong password
  • Database: Create new or use existing
6

Install

Click “Install” and wait 1-2 minutes
7

Login to WordPress

Visit https://your-domain.com/wp-admin with your credentials

Manual WordPress Installation

If one-click doesn’t work or you prefer manual control:
1

Create Database

In Plesk → Databases, create a new MySQL database and user
2

Download WordPress

Go to wordpress.org, download latest version
3

Upload Files

Extract the ZIP and upload contents to /httpdocs via FTP or File Manager
5

Configure Database

Enter database name, username, and password when prompted
6

Complete Installation

Create admin account and finish setup
7

Login

WordPress Security & Optimization

After installation, secure and optimize your WordPress site: Essential Plugins:
  • Jetpack or Akismet: Comment spam protection
  • WP Super Cache or W3 Total Cache: Performance caching
  • UpdraftPlus: Automated daily backups
  • Wordfence: Security scanning and firewall
Security Steps:
  1. Delete default “admin” user if it exists
  2. Update all plugins and themes
  3. Install security plugin
  4. Enable two-factor authentication
  5. Install SSL certificate (Plesk does this automatically)
Performance Tips:
  1. Install caching plugin
  2. Optimize and compress images
  3. Use a CDN for static assets
  4. Limit plugins to essential ones
  5. Update to latest PHP version in Plesk

Node.js Applications

Deploy modern JavaScript applications on Breeze Hosting.
Node.js support may vary by plan. Check with support if unsure whether your plan supports Node.js.

Deploying Node.js

Prerequisites:
  • Node.js application ready
  • Package.json with start script
  • node_modules dependencies defined
Steps:
1

Upload Application Files

Upload your Node.js application to a folder (not /httpdocs)
  • Create folder like /nodeapp or /api
  • Use FTP or Git deployment
2

Install Dependencies

SSH into your server and run:
cd /path/to/nodeapp
npm install
3

Configure Package.json

Ensure your package.json has a start script:
{
  "scripts": {
    "start": "node server.js"
  }
}
4

Test Locally

Run locally to verify:
npm start
5

Use Reverse Proxy

Configure nginx or Apache to proxy requests to your Node app (Your hosting provider may handle this)
6

Set Up Auto-Start

Use a process manager like PM2:
npm install -g pm2
pm2 start server.js --name "nodeapp"
pm2 startup
pm2 save
If Node.js isn’t working, contact Breeze support. Some plans may require VPS hosting for Node.js applications.

PHP Applications

Deploy PHP frameworks like Laravel, Symfony, or Drupal.

Deploying a PHP Application

Using File Manager:
1

Prepare Application

Your PHP app should be ready (all dependencies installed)
2

Create Database

Create a MySQL database in Plesk for your app
3

Upload Files

Upload application files to /httpdocs via File Manager or FTP
4

Configure App

Create .env or config file with database credentials
5

Set Permissions

Right-click folders in File Manager → Permissions:
  • /storage → 755 (Laravel)
  • /uploads → 755 (Drupal)
6

Run Setup

If needed, SSH in and run setup commands:
php artisan migrate  # Laravel
php bin/console doctrine:migrations:migrate  # Symfony

Laravel Deployment

Laravel requires a bit of extra setup:
1

Upload Laravel Files

Upload everything except vendor/ folder
2

Install Dependencies

SSH and run:
cd /home/username/public_html
composer install --no-dev
3

Configure Environment

Copy .env.example to .env and configure:
DB_HOST=localhost
DB_DATABASE=your_database
DB_USERNAME=your_user
DB_PASSWORD=your_password
APP_URL=https://your-domain.com
4

Generate Key

php artisan key:generate
5

Run Migrations

php artisan migrate
6

Set Permissions

chmod -R 755 storage bootstrap/cache
chown -R www-data:www-data storage bootstrap/cache
7

Update Document Root

In Plesk, set document root to /public folder

Git Deployment

Deploy directly from GitHub or GitLab.

Setting Up Git Deployment

Prerequisites:
  • GitHub or GitLab account with your repository
  • SSH key configured
Steps:
1

Generate SSH Key

On your server via SSH:
ssh-keygen -t ed25519 -f ~/.ssh/deploy_key
cat ~/.ssh/deploy_key.pub
2

Add SSH Key to GitHub/GitLab

  1. Log into your GitHub/GitLab account
  2. Settings → SSH Keys
  3. Add the public key from above
  4. Name it “Breeze Hosting”
3

Clone Repository

SSH into your server:
cd /home/username/public_html
git clone git@github.com:yourname/yourrepo.git .
4

Install Dependencies

If needed:
npm install      # Node.js
composer install # PHP
pip install -r requirements.txt # Python
5

Pull Updates

To update your site with latest code:
git pull origin main

Automated Git Deployments

Automatically deploy when you push to GitHub: Using GitHub Actions (Advanced): Create .github/workflows/deploy.yml:
name: Deploy to Breeze
on:
  push:
    branches: [main]
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - name: Deploy via SSH
        uses: appleboy/ssh-action@master
        with:
          host: ${{ secrets.DEPLOY_HOST }}
          username: ${{ secrets.DEPLOY_USER }}
          key: ${{ secrets.DEPLOY_KEY }}
          script: |
            cd /home/user/public_html
            git pull origin main
            npm install && npm run build
Set secrets in GitHub → Settings → Secrets.

FTP/SFTP File Uploads

Simple drag-and-drop file uploads using FTP or SFTP client. Connection Details:
  • Host: ftp.your-domain.com or your IP
  • Username: Your hosting username
  • Password: Your hosting password
  • Port: 21 (FTP) or 22 (SFTP)
  • Root: /httpdocs (for your main website)
Popular Clients:
  • FileZilla — Free, works everywhere
  • Cyberduck — Simple, Mac/Windows
  • Transmit — Mac only, premium
  • WinSCP — Windows only
After connecting, simply drag files from your computer to the FTP window.

Deployment Comparison

MethodEaseFeaturesBest For
File ManagerVery EasyBrowse/editSmall sites, quick updates
FTP/SFTPEasyBulk uploadAny site type
GitModerateVersion control, automationTeams, continuous deployment
One-Click InstallVery EasyAutomatic setupWordPress quickly
Manual InstallHardFull controlAdvanced users

Common Deployment Issues

404 Errors After Upload

Problem: Files uploaded but website shows 404 Solution:
  1. Verify files are in /httpdocs folder
  2. Ensure index.html or index.php exists in root
  3. Check folder permissions (should be readable)
  4. Clear browser cache
  5. Wait a few minutes for changes to take effect

Database Connection Errors

Problem: “Error establishing database connection” Solution:
  1. Verify database exists in Plesk
  2. Check username and password are correct
  3. Ensure database user has permissions
  4. Use localhost as database host (not server IP)
  5. Verify database wasn’t auto-suspended

File Permission Errors

Problem: Cannot write to folder, permission denied Solution:
  1. In File Manager, right-click folder
  2. Select “Permissions”
  3. Set to 755 for folders, 644 for files
  4. Check that user is “nobody” or “www-data”

Timeout on Large Uploads

Problem: Upload stops halfway, times out Solution:
  1. Use SFTP instead of FTP (faster, more reliable)
  2. Split large uploads into smaller batches
  3. Increase PHP upload limit if needed (contact support)
  4. Upload via SSH instead

Next Steps

SSL & Domains

Secure your website with SSL and manage your domains

Plesk Panel Guide

Master Plesk features, databases, email, and more

Getting Started

Return to initial setup and domain configuration
After uploading your website, always enable SSL (HTTPS) for security. Breeze provides free Let’s Encrypt certificates through Plesk.