Getting started with XenoDeploy

Install XenoDeploy, add a project, save its SSH connection, and deploy it: the plan first, then a live log.

5-minute read Applies to XenoDeploy 1.0.0 Updated

XenoDeploy deploys PHP sites from your Mac to servers you control, over your own SSH. Nothing is installed on the server, and no third party holds keys to it.

Before you start

You’ll need:

  • a Mac on macOS 15 or later, with Apple silicon
  • an SSH account on the server (a VPS, or a shared host like DreamHost or a cPanel host)
  • PHP on the server, and Composer there if your site builds with it
  • the project's folder on your Mac, ideally a git repository

Add the project

Drag XenoDeploy to Applications and open it. Click Add Project, choose the project's folder, and XenoDeploy detects its stack: Statamic, Laravel, WordPress or plain PHP. Answer the preset's questions (the server, the folder there, the URL), and XenoDeploy shows the settings it will write before you add it. They're kept in XenoDeploy's own folder, never in your project.

Statamic asks where content is edited. If editors use the Control Panel on the live site, choose On the server so a deploy never overwrites their work.

Save the SSH connection

If the server isn't a saved SSH connection yet, the project says so: click Set Up SSH…. The wizard makes a key, saves the connection in ~/.ssh/config and copies the key to the server; the only password it ever asks for is the server's, once, typed into ssh itself.

Plan, then deploy

Select the environment and click Deploy. XenoDeploy builds and stages the release on your Mac and reads the server, changing nothing, and shows the plan: the commit, the files that change, every hook by stage, migrations, drift, and how to roll back. Click Deploy to run exactly that plan, and follow it in the live log. An environment marked as production asks you to type its name first.

After the new release goes live, XenoDeploy checks the site is served from it. If the check fails, it asks whether to roll back.

Keep going

  • Doctor checks what the environment needs, on your Mac and on the server, with a fix for each problem.
  • Releases lists every release, with Roll Back to This….
  • The xenodeploy command does everything the app does: XenoDeploy › Install Command Line Tool… puts it on your PATH.

Questions about XenoDeploy?

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.