How to Install Ampache with Apache on Ubuntu Linux

Managing your music collection and streaming it across devices is easier than ever with Ampache, an open-source web-based media server. Installing Ampache on Ubuntu with Apache allows you to create your own streaming platform, giving you full control over your media library. This guide walks you through each step, from setting up your server environment to configuring Ampache for optimal use. Before starting, ensure your Ubuntu system is up to date and has a stable internet connection. You will also need root or sudo access to install packages and modify configurations.

What You’ll Need

Ubuntu Linux server (20.04 LTS or later recommended)
Root or sudo privileges
Basic knowledge of terminal commands
Access to the internet for package downloads
Optional: a domain name pointing to your server IP for easier access

Step-by-Step

Update your system packages: Open a terminal and run:
```
sudo apt update && sudo apt upgrade -y
```
Install Apache web server: Execute:
```
sudo apt install apache2 -y
```

Install PHP and required modules: Ampache requires PHP and some extensions:

sudo apt install php php-mysql php-xml php-mbstring php-curl php-zip php-gd php-intl php-bcmath php-ldap libapache2-mod-php -y

Install MySQL server: For database storage:
```
sudo apt install mysql-server -y
```
Secure MySQL installation: Run:
```
sudo mysql_secure_installation
```
Follow the prompts to set a root password and secure your database.

Create a MySQL database and user for Ampache: Log into MySQL:

sudo mysql -u root -p

Then execute:

CREATE DATABASE ampache CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'ampacheuser'@'localhost' IDENTIFIED BY 'yourStrongPassword';
GRANT ALL PRIVILEGES ON ampache.* TO 'ampacheuser'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Download Ampache: Navigate to your web directory and fetch the latest release:
```
cd /var/www/html
sudo wget https://github.com/ampache/ampache/releases/latest/download/ampache-x.y.z.tar.gz
```
Replace x.y.z with the current version number.

Extract and set permissions: Unpack the archive:

sudo tar -xzf ampache-x.y.z.tar.gz
sudo chown -R www-data:www-data ampache

Configure Apache: Create a new site configuration:

sudo nano /etc/apache2/sites-available/ampache.conf

Paste the following, adjusting ServerName if using a domain:

<VirtualHost *:80>
    ServerName yourdomain.com
    DocumentRoot /var/www/html/ampache
    <Directory /var/www/html/ampache>
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>
    ErrorLog ${APACHE_LOG_DIR}/ampache_error.log
    CustomLog ${APACHE_LOG_DIR}/ampache_access.log combined
</VirtualHost>

Save and enable the site:

sudo a2ensite ampache.conf
sudo a2enmod rewrite
sudo systemctl reload apache2

Configure Ampache: Visit http://your_server_ip/ampache/setup or your domain. Follow the on-screen instructions to connect to your MySQL database, set admin credentials, and customize settings. The installer will generate a configuration file at /var/www/html/ampache/config/ampache.cfg.php.
Finalize installation: Remove setup files if prompted, and ensure permissions are correct:
```
sudo chown -R www-data:www-data /var/www/html/ampache
```
Access Ampache: Open your browser and go to http://your_server_ip/ampache. Log in with your admin credentials and start adding your music files or configuring streaming options.

Common Mistakes

Not securing your MySQL installation, leaving default settings vulnerable.
Forgetting to enable Apache rewrite module, which is essential for URL rewriting and clean URLs.
Incorrect permissions on files or directories—ensure www-data owns the Ampache directory.
Misconfiguring the database connection during setup, leading to connection errors.
Not restarting or reloading Apache after configuration changes.

Tips

Use a domain name with SSL (via Let’s Encrypt) for secure streaming, especially if accessing over the internet.
Regularly update Ampache and your server packages to patch security vulnerabilities.
Organize your media files in a dedicated directory with proper permissions for smooth management.
Configure user accounts and permissions within Ampache for multi-user environments.
Backup your database regularly to prevent data loss.

Troubleshooting

If Ampache does not load properly or you encounter errors, here are some steps to diagnose and fix common issues:

Check Apache error logs: Run sudo tail -f /var/log/apache2/error.log to see recent errors that may indicate misconfigurations or permission issues.
Verify PHP modules: Ensure all required PHP extensions are installed and enabled. Use php -m to list modules.
Confirm database connection: Check the Ampache config file and test database connectivity with MySQL client.
Clear cache and cookies: Sometimes browser cache can cause display issues; clear them or try incognito mode.
Review permissions: Ensure the web server user (usually www-data) has access to all Ampache files and directories.
Revisit setup steps: If setup failed, rerun the installer or check for missing dependencies.

If problems persist, consult the Ampache forums or community documentation for specific issues.

Frequently Asked Questions

1. Can I install Ampache without using MySQL?

Yes, Ampache supports SQLite as an alternative database, which is easier for small setups but may have limitations.

2. Is Ampache secure for streaming over the internet?

Security depends on server configuration. Use HTTPS, strong passwords, and keep software updated to enhance security.

3. How do I add music files to Ampache?

Configure your media directory in Ampache settings, then scan or refresh the library to include new files.

4. Can I access Ampache from mobile devices?

Yes, Ampache is mobile-friendly and can be accessed via any web browser. You can also use dedicated apps that support Ampache.

5. How do I upgrade Ampache to a newer version?

Download the latest release, back up your database and configuration, then replace old files with new ones and run the installer if needed.

6. What should I do if I forget my admin password?

Use the database to reset the password manually or follow Ampache’s recovery procedures documented online.

How to Install Ampache with Apache on Ubuntu Linux

How to Install Ampache with Apache on Ubuntu Linux

What You’ll Need

Step-by-Step

Common Mistakes

Tips

Troubleshooting

Frequently Asked Questions

1. Can I install Ampache without using MySQL?

2. Is Ampache secure for streaming over the internet?

3. How do I add music files to Ampache?

4. Can I access Ampache from mobile devices?

5. How do I upgrade Ampache to a newer version?

6. What should I do if I forget my admin password?

Related