- Home
- Download
Download VXOST for macOS
Version 9.26.17 for macOS 13 or later, on Apple Silicon or Intel. Free, with the app and the dashboard under the GNU GPL.
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.
- Version
- 9.26.17
- Size
- 321 MB
- Requires
- macOS 13+
- Architecture
- Apple Silicon and Intel
- Licence
- App and dashboard: GNU GPL
Installing
- 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.
- 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.
- 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.
- 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:
- 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.dmgWithout 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.
- Open the disk image.
- In Terminal, type
sudo bashfollowed by a space. - 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 ofwww/projects/: from 9.26.9www/outsideprojectsbelongs to the system, so copy such a folder fromVXOST-old-<date>intowww/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 inhttpd.conf(the script says at the end how many there are, and in which file); - phpMyAdmin settings, and hand changes to
php.iniormy.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:
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.