Getting started with XenoHost

Install XenoHost, approve its helper once, and add your first site with HTTPS and its own PHP version.

5-minute read Applies to XenoHost 1.0.4 Updated

XenoHost runs Apache, PHP and MySQL on your Mac. It keeps its engines in /Applications/XenoHost, next to the app, and writes plain config files you can read.

Before you start

You’ll need:

  • A Mac with Apple silicon, running macOS 15 or later.
  • An administrator account, to approve XenoHost’s helper once.
  • For trusted HTTPS: mkcert’s local certificate authority. If it isn’t set up, XenoHost tells you what to run.

Running MAMP PRO too? Both can’t use ports 80, 443 and 3306 at once. Use the “alongside MAMP” ports (8080, 8443 and 3307) until you switch. See Import from MAMP PRO.

Add your first site

  1. Move XenoHost to Applications

    Drag XenoHost into your Applications folder and open it. It’s signed and notarized.

  2. Approve the helper

    XenoHost uses a small helper to edit its own marked block in /etc/hosts, and nothing else. macOS asks you to approve it once.

  3. Add a site

    Click New Site and choose the site’s folder. Give it a hostname such as mysite.local, pick its PHP version and turn on HTTPS.

  4. Review and Save

    Nothing changes until you click Save. The preview shows every file XenoHost will write, such as the virtual host and the hosts entry, and the services it will reload. Apply it, and XenoHost checks the site answers before it finishes. If it doesn’t, everything is rolled back and your edits are kept.

  5. Open it

    Open https://mysite.local in your browser, or use the site’s actions in the menu bar menu.

    Tip: Open in Terminal starts a shell in the site folder with the site’s exact PHP on your PATH, so php, composer and artisan use the same version as the site.

Add a database

In the site’s Databases tab, create or link a database, then copy its connection settings into your .env. MySQL listens on 127.0.0.1 only.

When something looks wrong

  • Open Server Status to see each service, its ports and its logs.
  • The Logs window shows the site’s Apache, PHP and Laravel errors with explanations.
  • Run xenohost doctor in Terminal for a full check of engines, ports, config and your CA.

XenoHost is an independent app and is not affiliated with, endorsed or sponsored by Apple Inc. iPhone, Safari, AirDrop, Bonjour, Mac and macOS are trademarks of Apple Inc., registered in the U.S. and other countries.

MAMP PRO is a trademark of its respective owner. XenoHost is independent and is not affiliated with or endorsed by its owner.

Questions about XenoHost?

Check the help pages first, or send us a message and we’ll get back to you within 24 hours.

Need help with an app or a license? Open a support ticket →

We reply within 24 hours on business days.