← Back to Documentation

🚀 Installation Guide

Get your Soonie coming soon page up and running in just a few minutes

System Requirements

Minimum Requirements:
  • PHP: 7.4 or higher (PHP 8.0+ recommended)
  • Web Server: Apache, Nginx, or any PHP-compatible server
  • File Permissions: Write access to the installation directory
  • Extensions: Standard PHP extensions (usually included)
  • Storage: Minimal disk space (under 5MB)

Quick Installation (5 Minutes)

1

Download & Extract

Extract the Soonie script files to your computer. You should see these files:

soonie/ ├── index.php # Main coming soon page ├── admin.php # Admin dashboard ├── config.php # Configuration file ├── .htaccess # Security settings ├── README.md # Basic readme ├── documentation/ # HTML documentation └── markdown/ # Markdown documentation
2

Upload Files

Upload all files to your web server using FTP, cPanel File Manager, or your hosting provider's upload tool.

Important: Upload to your domain's public folder (usually public_html, www, or htdocs)

For example:

  • Main domain: Upload to /public_html/
  • Subfolder: Upload to /public_html/yourfolder/
3

Set File Permissions

Ensure the script can write email data by setting proper permissions:

chmod 755 /path/to/your/soonie/directory # OR if needed: chmod 777 /path/to/your/soonie/directory

Most shared hosting providers set this automatically, but check if you encounter email saving issues.

4

Configure Basic Settings

Edit config.php to customize your page:

// ESSENTIAL SETTINGS TO CHANGE: // 1. Change admin password (CRITICAL!) define('ADMIN_PASSWORD', 'your_secure_password_here'); // 2. Set your company name define('COMPANY_NAME', 'Your Company Name'); // 3. Customize subtitle define('SUBTITLE', 'Your custom coming soon message...'); // 4. Set launch date (30 days from now) define('LAUNCH_DAYS_FROM_NOW', 30);
5

Test Your Installation

Visit your domain to see your coming soon page in action:

https://yourdomain.com

Test the admin panel:

https://yourdomain.com/admin.php
Success! If you can see the coming soon page and access the admin panel with your password, the installation is complete!

Advanced Installation Options

Custom Domain Configuration

If installing on a subdomain or subfolder, update your .htaccess file:

# For subfolder installation, add: RewriteBase /yourfolder/ # For subdomain, usually no changes needed

SSL/HTTPS Setup

For GDPR compliance and security, enable HTTPS:

# Uncomment in .htaccess to force HTTPS: RewriteCond %{HTTPS} off RewriteRule ^(.*)$ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]

Email File Location

By default, emails are stored in emails.txt. To change this:

// In config.php: define('EMAIL_FILE', 'custom_emails.txt'); // Or store in a subdirectory: define('EMAIL_FILE', 'data/emails.txt');

Post-Installation Checklist

✅ Verify these items after installation:
  • Coming soon page loads without errors
  • Countdown timer is working and shows correct date
  • Email form accepts and saves emails
  • Theme selector works (if enabled)
  • Admin panel is accessible with your password
  • Email export functions work
  • GDPR cookie banner appears (if enabled)
  • Mobile responsiveness looks good

Common Installation Issues

⚠️ "Permission Denied" Errors

Solution: Set directory permissions to 755 or 777

chmod 755 soonie/ # If still having issues: chmod 777 soonie/

⚠️ "PHP Version Not Supported"

Solution: Contact your hosting provider to upgrade to PHP 7.4+

⚠️ Admin Panel Won't Load

Solutions:

⚠️ Emails Not Saving

Solutions:

⚠️ Styling Issues

Solutions:

🎉 Installation Complete!

Your Soonie coming soon page is now ready! Next steps:

← Documentation Home Configuration Guide →