This Documentation describes the installation and configuration steps of phpSound.
Please ensure that your server meets the following minimum requirements:
|PHP 7, or higher||MySQLi, cURL, OpenSSL, GD, mbstring|
|Apache 2, or higher||mod_rewrite|
|MySQL 5, or higher|
After you've downloaded the product and extracted the contents from the
ZIP package, you can start the installation process.
3.1. Importing the database
- Create a new MySQL database (optional).
- Create a new MySQL username and password (optional).
- Import the
Database.sqlfile from the MySQL folder into your MySQL database.
3.2. Setting-up and uploading the files
- With a text editor open the /includes/config.php and update the values of
$CONF['email']with your own information.
- Upload the contents of the Script folder on the location where you want the product to be installed at.
- Set the CHMOD to 755, 775 or 777 (depending on the server configuration) to the following folders and their subfolders:
3.3. Finishing the installation
You're almost done, the last step is to access your Admin Panel (via
https://example.com/index.php?a=admin) using the default credentials:
Most of the phpSound's settings are pretty straight forward and self explanatory, but some of them require more advanced steps to get them working, which are covered in the next chapters.
4.1. Facebook Login
- Go to developers.facebook.com and Add a new App.
- Select the Facebook Login product and click Set up and choose the Web Platform.
- On Step 1 add your Site URL and click Save. Skip the rest of the steps.
- From the sidebar, under Facebook Login click on Settings and disable Client OAuth Login and Use Strict Mode for Redirect URIs.
- Under Valid OAuth redirect URIs add the following URL:
example.comwith your own domain name), and Save the changes.
- Go to your App Settings page, and copy the App ID and App Secret keys which you can use to enable Facebook Login.
- Turn on Facebook Login from Admin Panel > Site Settings > Registration and add your credentials.
4.2. Amazon S3 Storage
If you wish to create a new Theme or Language for phpSound download the Development Kit.
I have a support inquiry, a question or a problem, how can I contact you?You can contact us here.
What hosting do you recommend?We recommend using DigitalOcean (free $10 on signup), as they offer great performance and flexibility at an affordable price.
Is installation included in the price?No, installation is not included. We offer installation services for an extra fee. Contact Us.
How are the Track Plays counted?Track plays are counted each time you play a song.
How are the Popular Tracks being generated on the homepage?Popular Tracks are being generated based on the amount of plays each track had in the last 7 days.
What happens if I delete a track due to a DMCA complaint?The track will be permanently removed from your server.
What happens if I suspend a track due to a DMCA complaint?The track won't be available trough the website interface anymore (the track will remain on the server, in case a restore is needed).
Why Permalinks are not working on my site?Make sure you've uploaded the
.htaccessfile that comes with the software and that you have
mod_rewriteenabled on your server.
I can't find the
.htaccessfile, why?You're probably using MacOS, which by default is hiding the
.htaccessfile, enable the option to see hidden files.
How can I add a new site language?You can add a new site language by copying your new language file in the
My website returns a blank page, why?This generally happens when one of the server requirements is not met, you can check your current server configuration by accessing
How can I change my website's logo?You can change the Logo or the Site title from the Admin Panel > Site Settings > General tab.
How can I change my website's favicon?You can change the favicon from
How can I promote a user to Pro status?You can promote users by going to Admin Panel > Manage Users > Edit > General tab.
The timestamps of the posts are not correct, how can I fix them?You can change the Timezone of your server from the Admin Panel > Site Settings > General tab.
How can I remove the Powered by tag?You can remove the Powered by tag from the
How can I change a text string on my website?You can change any text from the language files located in the