Installation Guide
Follow these steps to install Votlie on your server. The process takes about 10-15 minutes.
Download and Upload
- Download the Votlie ZIP file from CodeCanyon
- Extract the ZIP on your computer
- Upload all files to your web server using FTP or File Manager
Where to upload:
- For main domain: Upload to
public_html/ - For subdomain: Upload to the subdomain's folder (e.g.,
feedback.yourdomain.com/) - For subfolder: Upload to a folder like
public_html/feedback/
Set File Permissions
Some folders need write permissions. Set these folders to 755:
storage/
bootstrap/cache/
In cPanel File Manager
- Right-click the folder
- Click "Change Permissions"
- Set to 755
- Check "Recurse into subdirectories"
- Click "Change Permissions"
Via Command Line
chmod -R 755 storage
chmod -R 755 bootstrap/cache
Create Database
If using MySQL, you need to create a database first.
In cPanel
- Go to "MySQL Databases"
- Create a new database (e.g.,
votlie_db) - Create a new user with a strong password
- Add the user to the database with "All Privileges"
Save these details - you'll need them in the next step: database name, database username, and database password.
Installation Wizard
- Open your browser
- Go to:
https://yourdomain.com/install - The installation wizard will guide you through a 7-step setup process
Step 4.1: License Activation
Enter your purchase code from CodeCanyon to activate your license.
- Purchase Code - Found in your CodeCanyon downloads page under "License Certificate"
- Environment - Select either Production (your live site) or Development (local/staging environments)
Click Activate & Continue to proceed.
Each purchase code supports one production installation. You can use the same code for a separate development environment.
Step 4.2: Welcome
- Review the installation overview
- Click Start Installation to begin
Step 4.3: Requirements Check
- The wizard checks your PHP version (8.1+ required) and required extensions
- Items in green are satisfied; items in red must be fixed before continuing
- Common required extensions:
BCMath,Ctype,cURL,DOM,Fileinfo,JSON,Mbstring,OpenSSL,PDO,Tokenizer,XML
Step 4.4: Directory Permissions
- Verifies that required folders are writable
- If any show "Not Writable", fix permissions (see Set File Permissions above)
- Required writable directories:
storage/,bootstrap/cache/
Step 4.5: Database Configuration
Choose your database type (MySQL or SQLite) and fill in the connection details:
| Field | Description | Example |
|---|---|---|
| Host | Database server address | localhost or 127.0.0.1 |
| Port | Database server port | 3306 (MySQL default) |
| Database Name | Name of the database you created | votlie_db |
| Username | Database user with access | votlie_user |
| Password | Password for the database user | Your secure password |
Click Test Connection to verify your credentials are correct. If the test passes, click Save & Continue.
If you chose SQLite, no connection details are needed -- the database file is created automatically.
Step 4.6: Admin Account
Create your administrator account. This will be the first user with full access to the admin panel.
| Field | Requirements |
|---|---|
| First Name | Your first name |
| Last Name | Your last name |
| Valid email address (used for login) | |
| Password | Minimum 8 characters, must include at least one uppercase letter, one lowercase letter, one number, and one symbol |
Click Create Admin Account to proceed.
Step 4.7: Complete
- Installation is finished and all database tables have been created
- Click Go to Login to access your new site
Step 5: Log In
- Go to your site URL
- Click Log In
- Enter the admin email and password you created during Step 4.6
- You are now in the admin dashboard
Installation Complete!
Your Votlie installation is ready. Next steps:
- First-Time Setup - Configure basic settings
- Branding - Add your logo and colors
- Email Setup - Configure email notifications
Common Issues
| Problem | Solution |
|---|---|
| Blank white page | Check PHP error logs. Usually a PHP version issue. |
| "Permission denied" | Set storage/ and bootstrap/cache/ to 755 |
| Database connection failed | Double-check your database name, username, and password |
| 500 Error | Enable error display in PHP or check error logs |
| Redirect loop | Clear browser cookies and cache |
For more help, see Troubleshooting.