Installation Guide

Complete installation guide for PostUno social media management platform

Step 1: Extract PostUno Files

📁 File Extraction
For Local Development

• Extract postuno-project-files-download-from-codecanyon (PostUno-Social-Media-Manager-v1.0.zip) to your local server directory:

macOS (Valet):     ~/Sites/postuno/
XAMPP (Windows):  C:\xampp\htdocs\postuno\
XAMPP (Mac):     /Applications/XAMPP/htdocs/postuno/
WAMP:           C:\wamp64\www\postuno\
MAMP:           /Applications/MAMP/htdocs/postuno/

For Live Server

Upload and extract files to your hosting:

cPanel/Shared:  public_html/  (for main domain)
                 public_html/postuno/  (for subdomain)
VPS/Dedicated:  /var/www/postuno/
Custom Path:    /your/custom/path/postuno/

Understanding the Folder Structure

After extracting PostUno, your folder structure looks like this:

postuno/                    ← Root folder (DO NOT point domain here!)
├── app/
├── bootstrap/
├── config/
├── database/
├── public/             ← ✅ YOUR DOMAIN MUST POINT HERE!
│   ├── index.php       ← This is the entry point
│   ├── assets/
│   └── ...
├── resources/
├── routes/
├── storage/
├── vendor/
├── .env
└── ...

❌ WRONG Configuration (Will NOT Work)

Domain: yourdomain.com
Points to: /home/username/public_html/     ❌ WRONG!

Result: 404 Error or blank page

✅ CORRECT Configuration (Will Work)

Domain: yourdomain.com
Points to: /home/username/public_html/public     ✅ CORRECT!

Result: PostUno works perfectly!

Step 2: Configure Domain Document Root

⚠️ This step is REQUIRED for live servers!

🌐 cPanel (Most Common)

🌐 cPanel: Change Document Root
📍 Where to Find This Setting

cPanel → Domains → Select your domain → Document Root
Step-by-Step Instructions

1. Log in to your cPanel

2. Find and click "Domains" or "Addon Domains"

3. Click "Manage" next to your domain

4. Find "Document Root" setting

5. Change it from: /home/username/public_html

6. Change it to: /home/username/public_html/public

7. Click "Update" or "Save"

For Subdomain Installation

If PostUno is in a subfolder (e.g., public_html/postuno/):

/home/username/public_html/postuno/public

Step 3: Server Setup (Optional)

(Skip if you already have Apache/Nginx/PHP configured)

🍎 macOS Valet Setup

🍎 macOS Valet
Install Valet

# Install Homebrew (if not installed)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install PHP 8.2
brew install [email protected]

# Install Composer
brew install composer

# Install Valet
composer global require laravel/valet
valet install

Setup Domain

# Navigate to your Sites directory
cd ~/Sites/postuno

# Link the site
valet link postuno

# Your site will be available at: http://postuno.test

💻 XAMPP Setup

💻 XAMPP
Download & Install XAMPP

1. Download XAMPP from apachefriends.org

2. Install XAMPP with PHP 8.2 or higher

3. Start Apache and MySQL services
Configure Document Root
Access your site at:

http://localhost/postuno/install

🌐 cPanel Hosting

🌐 cPanel
File Upload

1. Login to cPanel

2. Open File Manager

3. Navigate to public_html

4. Upload and extract PostUno files

Set Permissions

Set folder permissions to 755:
1.storage/
2.bootstrap/cache/
3.public/

Step 4: Create Database

🌐 phpMyAdmin

1. Open phpMyAdmin (usually at http://localhost/phpmyadmin)

2. Click "Databases" tab

3. Create new database named postuno_db

4. Select utf8mb4_unicode_ci collation

5. Click "Create"

📊 cPanel MySQL Databases

Create Database

1. In cPanel, find and click "MySQL Databases"

2. Under "Create New Database":

Enter database name: postuno
Click "Create Database"

Create User

1. Under "MySQL Users":

Username: postuno_user
Create a strong password
Click "Create User"

Add User to Database

1. Under "Add User to Database":

Select your database and user
Click "Add"
Check "ALL PRIVILEGES"
Click "Make Changes"

🐬 MySQL Command Line

🐬 MySQL/MariaDB

# Login to MySQL
mysql -u root -p

# Create database
CREATE DATABASE postuno_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

# Create user (optional)
CREATE USER 'postuno_user'@'localhost' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON postuno_db.* TO 'postuno_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Step 5: Run Installation Wizard

🧙‍♂️ Installation Wizard

Access Installation
Open your browser and navigate to:

Local Server:
  Valet: http://postuno.test/install
  XAMPP: http://localhost/postuno/install

Live Server:
  Domain: http://yourdomain.com/install
  IP:     http://your.server.ip/install

🛡️Installation Process

📊 Step 1: System Requirements Check

• The installer automatically verifies:

• PHP version (8.2 or higher required)

• Required PHP extensions

• Folder permissions

• Server configuration

🗄️ Step 2: Database Configuration

• Enter the database credentials you created in Step 3:

• Database Host: Usually "localhost"

• Database Name: Your created database

• Username: Database username

• Password: Database password

Click "Test Connection" to verify before proceeding.

👤 Step 3: Admin Account Setup

• Create your administrator account:

• Name: Your full name

• Email: Admin email address

• Password: Strong password (min 8 characters)

✅ Step 4: Installation Complete

• Installation is complete! You can now:

• Access your admin dashboard

• Configure social media integrations

← System Requirements ← Configuration Guide

PostUno > Troubleshooting

Troubleshooting

Common issues and their solutions

Common Installation Issues
🚨 404 Not Found / Document Root Issues

Solution:

Root Cause: Web server document root is not pointing to PostUno's /public directory

Fix Options:

1. Move contents of /public to document root (Recommended for shared hosting)

2. Configure virtual host (Recommended for VPS/dedicated)

3. Use .htaccess redirect (Quick fix)

🗄️ Database Connection Errors

Solutions:

Check Database Credentials: # Test connection manually mysql -h localhost -u your_username -p your_database_name

Verify Database Exists: SHOW DATABASES;

Check User Permissions: SHOW GRANTS FOR 'your_username'@'localhost'; 

📞 Getting Help

📞Contact Support
📖Knowledge Base