Letโs be realโinstalling XAMPP on macOS sounds simple enough. Go to the site, click the download button, and boomโฆ you’re up and running, right?
Wrong.
If youโve ever tried to install XAMPP on a Mac, you know it’s like going on a peaceful walk and suddenly falling into a pothole of Gatekeeper warnings, permissions issues, port conflicts, and sometimes just plain confusion.
Don’t worry. You’re not alone. This post is here to save your day, listing every annoying hurdle (with fixes!) so you can get back to doing what you actually want: building cool stuff.
? Problem 1: โApple cannot verify that this app is free from malwareโ
This is probably the first roadblock you’ll hit.
What it means: Appleโs Gatekeeper is blocking the installer because it’s not from a โverified developerโ (read: not notarized by Apple).
โ Fix:
- Right-click the installer > Click Open
- When the warning shows up again, youโll now get an โOpen Anywayโ option
- OR go to System Settings > Privacy & Security > Allow Anyway
As long as you downloaded XAMPP from the official Apache Friends website, you’re good.
? Problem 2: โPermission Deniedโ or Installer Doesnโt Open at All
Sometimes, even clicking “Open Anyway” leads toโฆ nothing. No progress bar. No window. Just silence. ?
โ Fix:
- Make sure the file has permission:
chmod +x ~/Downloads/xampp-osx-8.1.17-0-installer.app/Contents/MacOS/*
- Or try running the installer from the terminal:
sudo ~/Downloads/xampp-osx-8.1.17-0-installer.app/Contents/MacOS/installbuilder.sh
Yes, Macs are picky. You’re not doing anything wrong.
? Problem 3: Apache Wonโt Start (Port 80 Already in Use)
You finally get XAMPP installed, but when you try to start Apache, it fails. The logs say:
โPort 80 is already in use.โ
??โโ๏ธ Whatโs using Port 80?
Most likely: macOSโs built-in web server or Skype/Zoom/Dropbox.
โ Fix:
Run this in terminal:
sudo lsof -i :80
Then kill the process:
sudo kill -9 <PID>
Or go to System Preferences > Sharing, and disable โWeb Sharingโ if itโs on.
? Problem 4: MySQL or ProFTPD Not Starting
XAMPP looks like it installed fine, but MySQL or FTP refuses to run.
โ Fix:
- Make sure no other MySQL server (like MAMP or Homebrew MySQL) is already running.
- Check logs under
/Applications/XAMPP/xamppfiles/logs/for more info. - Restart your Mac (it works more often than you’d think).
? Problem 5: XAMPP Control Panel Doesnโt Look Right or Freezes
Sometimes the GUI is glitchy, unresponsive, or shows nothing when you launch it.
โ Fix:
- Try launching it from Terminal:
sudo /Applications/XAMPP/xamppfiles/xampp control-panel
- Or use Terminal-only commands:
sudo /Applications/XAMPP/xamppfiles/xampp start
Bonus tip: Use XAMPP-VM version only if you’re sure you want to run it in a virtual machine. For most devs, the regular macOS version is easier.
? Problem 6: Canโt Access localhost in Browser
Even though Apache is running, going to http://localhost just gives you a blank screen or error?
โ Fix:
- Try visiting
http://127.0.0.1instead - Clear your browser cache
- Check your
hostsfile:
sudo nano /etc/hosts
Make sure this line exists:
127.0.0.1 localhost
? Pro Tips After Installation
- Move your projects into:
/Applications/XAMPP/htdocs/ - Access your project in browser via:
http://localhost/your-folder-name - Use phpMyAdmin at:
http://localhost/phpmyadmin
โจ Final Thoughts
Installing XAMPP on Mac shouldnโt feel like climbing a mountain in flip-flops. But letโs face itโbetween macOS security features, port conflicts, and permission quirks, it kinda does.
But now? You’re ready.
You’ve got all the fixes.
And heyโif you survived this, you’re already a tougher dev than you were an hour ago.