One image, everything inside: Apache, MariaDB, PHP, Perl and phpMyAdmin, with the app and the redesigned dashboard. Drag it in and the machine serves a site.

The package is published here alone: one file to download, one fingerprint to compare it against, and nothing else to choose.

v9.26.17Updated November 2026Free · app and dashboard GPL
Version
9.26.17
Size
321 MB
Requires
macOS 13+
Architecture
Apple Silicon and Intel
Licence
App and dashboard: GNU GPL
one downloadserver, database and app together
15 languagesinstead of one
zero dependenciesnothing to install first
Apple Silicon and Intelnative app, servers via Rosetta 2
macOS will block it the first time. The app is ad-hoc signed and not notarised, which requires a paid Apple Developer account. This is not a sign that anything is wrong with the download: it happens to every application distributed without one.

Installing

  1. Already have VXOST? Stop here and follow Updating from an earlier version: dragging the new folder over the old one deletes your projects and databases.
  2. Open the disk image. There are two things inside, and both go onto the Applications shortcut next to them: the VXOST folder, which is the server, and VXOST.app, which is the app you open every day. Dragging only the app leaves you with nothing to start.
  3. Allow it once. Try to open it, dismiss the warning, then go to System Settings → Privacy & Security, scroll to the bottom and choose Open Anyway.
  4. Start your services from the Dock icon or the menu bar. macOS asks for your password, because starting the servers needs administrator rights.

From Terminal instead

If you would rather not go through System Settings:

xattr -dr com.apple.quarantine /Applications/VXOST.app

Which Macs it runs on

The app is a universal binary: it runs natively on every Apple Silicon Mac, M1 through M5, including the Pro, Max and Ultra variants, and on Intel Macs, on macOS 13 or later.

The bundled servers are a different matter, and worth being straight about. Apache, MariaDB, PHP and Perl are prebuilt binaries from an existing open-source distribution for macOS, and they are Intel binaries. On Apple Silicon they run through Rosetta 2, which macOS installs on demand the first time something needs it. They work, and have done since the M1, but they are translated rather than native, so if you are comparing raw database throughput against a native install, that is where the difference comes from.

The full stack

Everything in one image, 321 MB: the five components, the redesigned dashboard and the app. The database ships empty, no tables, no data, with root / root on 127.0.0.1:3306, which is what phpMyAdmin and local projects expect.

Download the full stack (321 MB) →  ·  What each component is

Those credentials are meant for a machine only you can reach. If the installation is ever exposed beyond your own computer, change them first.

Updating from an earlier version

Your projects, databases and virtual hosts live inside the VXOST folder. Do not drag the new folder over the old one: Finder replaces the whole folder, and everything in it is deleted. Replacing only VXOST.app is not an update either: the servers stay the old ones.

From 9.26.7 on, changes to the app, the dashboard and the control scripts are meant to arrive from the app itself, under Check for updates in the menu bar menu, signed and without downloading the disk image again. If you have 9.26.8, every version from 9.26.9 to 9.26.17 arrives that way as one update: choose Check for updates, then Install. On 9.26.7 the app installs 9.26.8 first, then the rest. The disk image is for a new installation, or for a version before 9.26.7: its update script brings that installation straight to 9.26.17.

With your current VXOST still in Applications, and the new disk image downloaded but not opened yet:

  1. Check the image as shown in Verify what you downloaded, then, in Terminal, clear the download flag macOS puts on it:
    xattr -d com.apple.quarantine ~/Downloads/VXOST-Stack-9.26.17.dmg
    Without this, macOS stops the update script with "Apple cannot verify that it is free of malware", because the script is not notarised. Once the checksum matches, clearing the flag only removes the macOS warning: it is the same file this site published.
  2. Open the disk image.
  3. In Terminal, type sudo bash followed by a space.
  4. Drag Update an existing VXOST.sh from the disk image onto the Terminal window, press Return, and enter your password.

The script checks everything first: if something is not right it stops and says why, before changing anything. It stops the servers and makes sure they stopped (MariaDB is never forced), keeps your current installation in Applications as VXOST-old-<date>, installs the new version, moves your projects folder into it and copies your databases, virtual hosts and ports. Moving takes no time and no disk space, and your projects end up at the same path as before. If anything fails halfway, everything goes back where it was, projects included. It deletes nothing.

Close your code editors before updating. A Time Machine backup first is still a good idea. Your time tracking history is not in the VXOST folder and is not affected.

Some things stay in VXOST-old-<date>, because they may conflict with the new version, and are not copied:

  • sites placed directly in www/ instead of www/projects/: from 9.26.9 www/ outside projects belongs to the system, so copy such a folder from VXOST-old-<date> into www/projects/, which stays yours. The site is then served under /projects/<name>/;
  • virtual hosts and certificates set in httpd-ssl.conf, and virtual hosts written directly in httpd.conf (the script says at the end how many there are, and in which file);
  • phpMyAdmin settings, and hand changes to php.ini or my.cnf.

From 9.26.9 the VXOST files are owned by the system, so changing them needs your Mac administrator password: copying a file into the installation takes sudo cp, and editing one takes sudo nano, for example sudo nano /Applications/VXOST/vxostfiles/etc/php.ini (Ctrl+O then Return to save, Ctrl+X to leave).

At the end the script prints how to go back, which puts VXOST-old-<date> back in place: so copy what you need from it, do not move it, and carry hand changes to php.ini or my.cnf over by hand rather than copying the old files on top of the new ones. Your HTTPS certificate and key are carried over by the script.

Only when everything works, delete VXOST-old-<date>: your projects are no longer in it, they were moved to the new installation.

Verify what you downloaded

Check the file against its published checksum before opening it, which takes one command:

cd ~/Downloads && shasum -a 256 VXOST-Stack-9.26.17.dmg

It should print a7c7bb72eabf77665bdcebc25f871c8f6055ce9dfbe37892484b5b6a331667b9. The same value is in SHA256SUMS.txt, which is where this page reads it from.

Release notes

The notes of every version from 9.26.9 to 9.26.17, newest first, as a plain text file. Worth keeping next to your install.

Download release-notes-9.26.17.txt (11 KB) →

The dashboard

The redesigned web root is already inside the package, as readable source with no build step: the pages are served as they are.