Configuring VirtualHosts in XAMPP on Mac. A few weeks back I rejoined the “Cult of Mac” when I replaced my old Asus notebook with a MacBook Pro, and since then I’ve been busy settling into my new OS X workflow. I do all my development locally, so one of the first applications I installed was XAMPP, a cross platform Apache/MySQL/PHP stack. The XAMPP welcome page. To have Apache serve your own web site content there are two main options. The first is to place it within the default DocumentRoot.The second is to place it outside of the default DocumentRoot and use the Alias directive to map a URL to this location. I installed XAMPP on my mac months ago and was working great. Now i get 'Test Page For Apache Installation' when i try to browse /localhost. And /localhost/xampp is not found. But when i browse /127.0.0.1 it just works as localhost used to be. I double checked my /etc/hosts file that i have 127.0.0.1 localhost and not commented.
From Joomla! Documentation
- 1.2Installation on Linux
- 1.3Installation on Mac OS X
XAMPP ist ein einfach zu installierendes Paket, das den Apache-Webserver, PHP, XDEBUG und die MySQL-Datenbank zusammenfasst. Damit kann man die notwendige Arbeitsumgebung für den Betrieb von Joomla! auf einem lokalen Computer einrichten. Die aktuelle Version von XAMPP ist auf der XAMPP-Website zu finden. Downloads sind für Linux, Windows, Mac OS X und Solaris verfügbar. Bitte das Paket für die jeweilige Systemumgebung herunterladen.
Wichtiger Hinweis zu XAMPP und Skype: Apache und Skype verwenden beide den Port 80 für eingehende Verbindungen. Wenn Sie Skype verwenden, gehen Sie in das Fenster „Tools-Options-Advanced-Connection“ und deaktivieren Sie die Option „Use 80 and 443 as alternatives for incoming connections“. Wenn der Apache als Dienst gestartet wird, wird er Port 80 benutzen, bevor Skype startet und es wird kein Problem auftreten. Deaktivieren der Option in Skype ist trotzdem zu empfehlen.
Installation auf Windows
Die Installation für Windows ist sehr einfach. Man kann das XAMPP-Installationsprogramm verwenden (z.B. „xampp-windows-x64-8.0.0-3-VS16-installer.exe“). Eine ausführliche Installationsanleitung für Windows ist hier verfügbar.
If you are on Windows XP or 2003 they are not supported by the main package but there are compatible versions of XAMPP for these platforms listed on the download page (but you will only be able to run PHP 5.4 or lower - and therefore will only be able to test Joomla 3.x and lower).
For Windows, it is recommended to install XAMPP in 'c:xampp' (not in 'c:program files'). If you do this, your Joomla! (and any other local web site folders) will go into the folder 'c:xampphtdocs'. (By convention, all web content goes under the 'htdocs' folder.)
If you have multiple http servers (like IIS) you can change the xampp listening port. In <xamppDir>apacheconfhttpd.conf, modify the line Listen 80 to Listen [portnumber] (ex: 'Listen 8080').
You can find a detailed tutorial on installing XAMPP on Windows, along with the Joomla 4 Beta, the Joomla Patch Tester and Git in this Joomla Community Magazine article.
Installation on Linux
Open Terminal and enter:
(replace xampp-linux-1.7.7.tar.gz with the version of xammp you downloaded).It has been reported that the MYSQL database of xampp 1.7.4 does not work with Joomla 1.5.22
This installs .. Apache2, mysql and php5 as well as an ftp server.
starts/stops all the services
Test your XAMPP localhost server
Open your Browser and point it to
The index.php will redirect to
There you will find instructions on how to change default usernames/passwords. On a PC that does not serve files to the Internet or LAN then changing the defaults is a personal decision.
Download the latest Joomla instalation zip 
Unzip to your hard drive
Connect to localhost with an FTP client Default
Create a folder for your Joomla on the localhost server
FTP the unpacked Joomla installation files to the newly created Joomla folder.
- The xammp installation sets the correct Ownership of the files and permissions.
- Using the CHOWN command will cause Ownership problems with xampp.
- Using nautilus to manipulate folders/files on localhost will cause Ownership problems with xampp.
Default Database name
Default Database user
There is no default Password.
Administrator password is your choice.
Installing Sample Data is recommended for the novice user.
After installation delete the installation directory and point your Browser to:
Creating a link in the Ubuntu menu
To create a GUI for xammp connected to your Ubuntu menu
Open up the Terminal and type
Then copy the following into the gedit and save. Quickbooks recurring invoice.
If the control panel fails to launch, try running the Exec command directly in the terminal:
If you receive the error:
Install the missing libraries:
XDebug PHP debugger
The XAMPP package for Linux does not includes the XDebug PHP debugger. To install XDebug on Debian or Ubuntu:
- Install the build-essential package:
- Download the development package for your version of XAMPP and extract it over your existing installation:
- Build XDebug:
After this you will have following output on your console…
Then the output will be this. please monitor the directory specified.
Create a folder in your temp folder that will holds the data file generated by XDebug:
Install using PHP extensions community library (PECL) bundled with xampp:
On Ubuntu/Debian you can install using:
(warning: this will also install Apache and PHP from apt repositories).
Warning for 64bit users
When compiling XDebug or installing via apt-get, you will receive an error when (re)starting xampp:
This is because xampp runs 32bit but XDebug is 64bit. To overcome this problem, either make xdebug.so on a 32bit machine or download it from:
Download the file: 'PHP Remote Debugging Client' for 'Linux (x86)'Extract the content of the file on your computer, this compressed file contains several folders with version numbers ex: 4.4, 5.0, 5.1 .. 5.3 and so forth, get in the folder with the higher version number or the one that works for you, then manually copy the file 'xdebug.so' to the following location, overwrite if needed
Remember this location could be different on your computer
Installation on Mac OS X
Mac OS X actually includes an Apache server out-of-the-box, but most developers will prefer to use the integrated tools and configurability provided by XAMPP.
As with most programs on Mac, installation is a breeze. Visit Apache Friends - Mac OS X for the universal binary download.
Once the file has finished downloading, just open the disk image, and drag the XAMPP folder to the 'Applications' folder alias.
To start the server, open 'XAMPP Control.app' and press the start button next to Apache.
A Little Troubleshooting
Many Mac users have a little difficulty at this stage when trying to set up another instance of Apache on their machine. If you cannot start XAMPP's Apache, you have two options:
You can change the listening port of XAMPP. In ApplicationsXAMPPxamppfilesetchttpd.conf, modify the line that says, 'Listen 80' to Listen [portNumber]. E.g.:
You can change the listening port of the pre-installed Apache server. In finder, go to '/etc' (CMD+SHIFT+G); from here you will be able to navigate through the normally hidden Apache files. Find the folder labeled Apache2, and edit the 'http.conf' file. Modify the line that says, 'Listen 80' to Listen [portNumber]. E.g.:
Note: If you choose to change the port of the pre-installed Apache server, you may need to restart your computer for changes to take effect. You will also have to authenticate as an administrator to change these files.
Test XAMPP Installation
Once XAMPP is installed and you have started the Apache service with the XAMPP Control Panel tool, you can test it by opening your browser and navigating to 'http://localhost'. You should see the XAMPP welcome screen similar to the one below.
Select the link called 'phpinfo()' in the top menu. This will display a long screen of information about the PHP configuration, as shown below.
At this point, XAMPP is installed successfully. Notice the 'Loaded Configuration File'. We will be editing this file in the next section to configure XDebug.
|- ALT Linux|
|- Arch Linux|
|- Debian or Ubuntu|
|- Red Hat Enterprise Linux or CentOS|
|- Solaris 11 / opensolaris|
|- Solaris 10|
|- Windows Server 2019|
|- Windows Server 2016|
|- Windows Subsystem for Linux|
|on a stick|
|- Uniform Server|
XAMPP can be used to get an environment for your MediaWiki installation up and running pretty quickly on your local machine or for a portable version on a USB drive if you use XAMPP Portable version.
Getting Apache and MySQL running
Localhost Xampp Administrator
- Download the latest version for your platform (Linux, Windows, Mac OS X, or Solaris) from apachefriends.
- Run the executable to extract it (you can extract it straight to C: if you want; it'll create an XAMPP subfolder and put all the files there) and answer the questions setup will ask you. Rename the folder to XAMPP. The minimum required components are Apache, MySQL, PHP and phpMyAdmin.
- At the end, setup will give you an option to start the XAMPP control panel; select that option and it should pop up.
- Check the checkboxes for Apache and MySQL and click on their respective Start buttons to start those.
- If a port conflict occurs when starting the Apache web server, then the port for Apache must be changed, e.g. change 80 to 8080 (httpd.conf) and 443 to 4433 (httpd-ssl.conf). The service ports in xampp-control.ini must be changed in the same way.
- You may encounter a MySQL port conflict in XAMPP if you have installed MySQL before in the system. In this case you need to change the port number for XAMPP. For example: https://stackoverflow.com/a/39741578/5632906.
Creating your database
- Direct your browser to http://localhost/dashboard/ or e.g. http://localhost:8080/dashboard/ if the port has been changed to 8080
- Go to phpMyAdmin at the top of the page
- Sign in
- Click Databases on the top bar.
- Choose a name e.g. wikidb, select a collation e.g. if your wiki is using utf8 for its default charset then choose utf8_unicode_ci, and click Create)
- Go into the new database and click on Privileges on the top bar.
- Click Add a new user
- Enter a name for the user (e.g., wikiuser), a password and for the hostname select Local/localhost. You can leave all the rest blank. You may want to write down your database name, user name, and password, because you'll need those to install MediaWiki.
- Click the radio button for 'Grant all privileges on database 'xxx'
- For Global privileges select check all
- Click Go.
To make sure that the Apache HTTP server doesn't time out during the creation of the databases, modify the php.ini config file:
Xampp Localhost Page
- Open the php.ini (can be found in the folder /path_to_xampp/php; in most linux distributions, this file has the the path /opt/lampp/etc/php.ini ) file using your favorite text editor and find the following section and change to max_execution_time = 600.
- Save the file and restart Apache
Setting up MediaWiki
- Extract all your MediaWiki files and folders into a subfolder e.g. mywiki of the htdocs folder, wherever that is e.g. c:xampphtdocs.
MediaWiki is downloaded as .tar.gz file. To unpack such archive the following command can be used in Windows cmd or PowerShell:
tar xzvf your-file-name.tar.gz, e.g.
tar xzvf mediawiki-1.35.1.tar.gz.
- Direct your browser to the appropriate page, e.g. http://localhost/mywiki
- Follow the MediaWiki installer's instructions, entering the database name, user name, and password you wrote down during the 'creating your database' step above.
- If you enabled the 'security' option, then you need to Use superuser account. This means the MySQL root account and its password.
- After MediaWiki tells you that everything went smoothly, save your LocalSettings.php file to your wiki's root folder, e.g. c:xampphtdocsmywiki.
- Direct your browser once again to the appropriate page, e.g. http://localhost/mywiki. It should take you to the Main Page of your new wiki. Congratulations! You're done.
- Add any extra extensions your wiki is going to require.
Main article: Manual:Backing up a wiki
- In SQL admin, go to the wiki database (typically wikidb), and click Export. Check the first box under 'structure' (DROP TABLES), and check the 'save as file' checkbox near the bottom. Click Go and save the file to the backup location.
- Save a copy of the wiki folder, e.g. mywiki from c:xampphtdocsmywiki to the backup location.
Main article: Manual:Restoring a wiki from backup
- Install XAMPP on the new server.
- In SQL admin:
- Create a new blank database with the default options and a name of your choice.
- Import the database file you backed-up.
- Change the SQL password of the root for that db (in privileges tab)
- Copy the wiki folder from back-up into the new htdocs folder.
- Change LocalSettings.php to reflect the new db username and password.
Maximum execution time exceeded
If you get Fatal error: Maximum execution time of xx seconds exceeded .. edit the file config.inc.php in folder phpMyAdmin and set $cfg['ExecTimeLimit'] = 0;
Mac Xampp Localhost Access Forbidden
- Software bundles for AMPs with MediaWiki built in.
Localhost Xampp Htdocs Index Html
- Run Your Personal Wikipedia from a USB Stick, uses XAMPP
- NetBeans Guide to Installing and Configuring the XAMPP Package