Easy VirMach Deployment with DeployHQ: Streamlined VPS Workflow

Deploying to your site hosted with VirMach is very simple with DeployHQ. VirMach offers budget VPS hosting with full root SSH access.

Firstly, you'll need to set up your DeployHQ project, then connect to your VirMach server.

Setting up your project

Head to the Projects screen in DeployHQ, then click the New Project button to get started.

You'll be prompted to enter a name for your project, then select where your repository is hosted.

Next, click Create project and you'll be taken to a screen where you can log in with your repository hosting account to authorise access and then choose your repository.

• Adding a Bitbucket repository
• Adding a Codebase repository
• Adding a GitHub repository
• Adding a GitLab repository
• Adding a repository manually

Setting up VirMach

Once you've configured your repository, you'll need to connect to your VirMach VPS.

Before connecting, make sure your server's firewall settings are not blocking DeployHQ's IPs. VirMach uses SolusVM or KiwiVM as the control panel — check the firewall section in your panel. For the list of IPs to allowlist, see DeployHQ's IP ranges.

Your server's IP address can be found in the VirMach client area or in your service activation email. The default SSH user is root on port 22.

Head to Servers & Groups in DeployHQ, and click the New Server button at the top of the screen. If you've just added your repository, you will have been taken to this page automatically.

Start by entering a name, and choosing SSH/SFTP as the protocol:

You'll need to add DeployHQ's SSH public key to your server. Copy the key from the server configuration page and add it to ~/.ssh/authorized_keys on your VPS.

Next, enter your VirMach server's IP address as the hostname, your username (root or a custom user), and leave the port blank to use the default (22).

For the deployment path, enter the directory where your files should be uploaded:

• Apache/Nginx: /var/www/html/ or /var/www/your-domain/
• WordPress theme: /var/www/your-domain/wp-content/themes/your-theme/
• Custom app: Any path your user has write access to

Within Deployment options, you can choose to automatically deploy your server and, if you're only deploying files from a certain directory in your repository, enter a Deployment subdirectory.

Click Create Server to finish, then you can proceed to start your first deployment.

Run your first deployment

By default, DeployHQ will upload the whole repository to your server on the first deployment, because there is no previously deployed commit to compare to.

If your files are already on your VirMach server and up to date with the latest commit, you can follow this guide to skip that first deployment:

• Don't deploy your whole repository on the first deployment

Otherwise, just follow this guide to start your first deployment, then after the first deployment, only files that have changed will be uploaded in future.

• Running your first deployment

That's it! You've now set up and run your first deployment to your VirMach server and your future changes will be uploaded for you automatically, or at the simple click of a button.

Further reading

DeployHQ has a number of very useful features to help with your deployments in general that you might wish to find out more about:

• Compiling assets and javascript with the Build pipeline
• Running commands on your server with SSH commands
• Stop certain files from being uploaded in deployments using Excluded files
• Keep important files safely away from your repository using Config files
• Keep your team in the loop and run other useful tasks during a deployment with our Integrations