Requirements
# |
Recommended |
| Server | VPS, Cloud, or Dedicated (Get 20€ Free Cloud Server Credits) |
| Linux OS | Debian 10 / Ubuntu 20.04 |
| Web Panel | aaPanel |
| Web Server | Apache 2.4 |
| Web Server Mods | mod_rewrite (URL rewriting) |
| PHP | 7.4, 8.1+ |
| PHP Extensions | ionCube Loader, cURL, fileinfo, redis |
| PHP Functions enabled | putenv, exec, chown, pcntl_signal, pcntl_alarm, popen, proc_open, dl, apache_setenv |
| Database | MySQL 8 / MariaDB 10.7 |
| Conversion Software | FFmpeg & FFprobe static build |
| Processes Control | Supervisor |
| In-Memory Database / Cache | Redis |
Recommended installation
1) In aaPanel, click on "Website" in the left-hand menu, and then click on your MP3ConverterPro Domain's Document Root directory value
2) Delete all automatically created files. (Ignore .user.ini, because it can't be deleted.)
3) Upload the "MP3ConverterPro-v3.zip" distribution file (via Drag & Drop) and click Upload. After Successful Upload, close the Upload window.
4) Now, click on Terminal
5) Unpack the ZIP file on your Server, move files to the domain's web root directory, and delete temporary files/folders
sudo -u www unzip MP3ConverterPro-v3.*.*.zip && mv mp3converterpro/* mp3converterpro/.??* . && rm -rf mp3converterpro MP3ConverterPro-v3.*.*.zip
6) Install dependencies via Composer
sudo -u www composer install --no-dev
7) Generate .env Config file
sudo -u www cp .env.example .env
8) Generate unique APP Key
php artisan key:generate
9) Close the Terminal, click the Refresh Button (to the Right of the current directory path, e.g., Root dir > www > wwwroot > example.com) to see the extracted files/folders, open the .env file (Double-Click it), and edit your settings in the built-in editor
APP_NAME="MP3 Converter Pro"
APP_URL=http://example.com
# Your MySQL Database Login details here
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=mp3converterprov3
DB_USERNAME=your_user
DB_PASSWORD=your_password
FFMPEG_BINARIES="/usr/local/bin/ffmpeg"
FFPROBE_BINARIES="/usr/local/bin/ffprobe"
# Cache your admin panel settings to reduce database overhead.
SETTINGS_CACHE_ENABLED=true
# Cache Driver can be "file" or "redis"
CACHE_DRIVER=file
# If you want to use redis, set up your redis settings here.
REDIS_HOST=127.0.0.1
REDIS_PASSWORD=null
REDIS_PORT=6379
...
10) Navigate to the "public" folder, open .user.ini, and change its content to:
open_basedir=
11) Now, open the Terminal again, and Migrate and Seed Database
php artisan migrate --seed
12) In aaPanel, click on "Website" in the left-hand menu, click on your MP3 Converter Pro Domain (in the "Site name" column), go to Site Directory > Running directory, set the value to "/public", and click save
13) In aaPanel, click on "App Store" in the left-hand menu, click the "Installed" button at the top of the page, find "Supervisor" in the resulting list of software, click on its Settings, and configure Supervisor (for the Download Queue)
Name: MCP_QueueRun User: wwwRun Dir: /www/wwwroot/yoursite.com/Start Command: php artisan queue:work --sleep=3 --tries=1 --max-time=3600 --timeout=2000Processes: NUMBER OF CPU THREADS (on your server) x 4 (e.g., 4 x 4 = 16)
14) In aaPanel, click on "Cron" in the left-hand menu, and then set up a Cron Job to delete old, cached files
Type of Task: Shell ScriptName of Task: Delete File CacheExecution cycle: Hourly 30 MinuteScript content: php /www/wwwroot/yoursite.com/artisan schedule:run
15) Navigate to the Admin Panel and log in with the following credentials:
http://yoursite.com/admin
Login: admin@admin
Password: 12345678
...Then click on the "admin" dropdown menu (at the top-right of page), select Profile, and update your Email and Password
16) In the Admin Panel, click on Settings, go to License Settings, add your Product License key, and then click the corresponding Save button. On the same page, go to Backend Settings, add your Backend URL and API key, and then click its corresponding Save button.
