October DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsWindows FixRecommendedWindows errors stealing your time? Find the fix fastScan stability, cleanup and performance issues.Fix NowOctober DealsAmazon USDeal season is back - check today's better picksAmazon US: current deals, useful picks and tech finds.See Picks×
Skip to content
VGSources
Blog

How to Install HHVM on an Ubuntu VPS (Including Ubuntu 24.04 Checks)

A practical HHVM VPS installation guide covering the official APT repository, signing-key setup, Ubuntu codename checks, version pinning, verification, troubleshooting, Docker fallback, and source-build requirements.
Length9 min Posted Quest giverVGSources Team
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

The supported installation route is HHVM’s APT repository at https://dl.hhvm.com/ubuntu. Add the signing key, configure the repository for your Ubuntu codename, run apt update, and install the hhvm package. Ubuntu 24.04 uses the noble codename, but the official Linux instructions do not confirm that a noble package suite exists. Check the repository before changing your VPS; if it is absent, use the official Docker image or build HHVM from source instead of pointing APT at another Ubuntu release.

What you need before installing

This procedure changes system APT configuration, so use an account with sudo access and take a VPS snapshot if you need an easy rollback. The commands below assume a 64-bit Ubuntu server with working DNS and outbound HTTPS access.

As an Amazon Associate I earn from qualifying purchases.

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  • Ubuntu installed on the VPS and an account that can become root.
  • A resolved Ubuntu codename, such as jammy or noble.
  • HTTPS access to dl.hhvm.com and to Ubuntu package mirrors.
  • Permission to install system packages and add a file under /etc/apt/sources.list.d/.

Do not copy an old tutorial without checking its target release. Many online guides were written for Ubuntu 14.04 through 20.04 and use the historical apt-key workflow. The HHVM documentation still shows a keyserver command, but repository availability and key-handling recommendations can change, especially on newer Ubuntu releases.

1. Confirm the Ubuntu release and codename

Run these commands before adding any HHVM source:

lsb_release -a
lsb_release -cs
. /etc/os-release && printf '%sn' "$PRETTY_NAME"

The second command prints the codename APT expects. Ubuntu 24.04 should print noble. Record the value; it must match the suite used in the HHVM repository entry. If lsb_release is missing, read VERSION_CODENAME from /etc/os-release or install the distribution’s release-information package before continuing.

#1 Best Overall
Sale
GMKtec G3S Mini PC Intel N95 Processor (Up to 3.4GHz) 8GB RAM 256GB M.2 SSD | Mini Desktop Computer with VESA Mount for Office Home Business HTPC Proxmox, Dual 4K Display, WiFi 5, Gigabit Ethernet
  • 12th Intel Alder Lake N95 Processor – The GMKtec G3 S Mini PC is powered by the 12th Gen Intel N95 processor with 4 cores, 4 threads, 6MB cache and a burst frequency up to 3.4GHz. Compared with N100/N5105/N5100/N5095, the N95 delivers up to 36% overall performance improvement. Perfect for routine tasks, office work, and home entertainment, this compact mini desktop is more convenient than traditional bulky PCs.
  • 8GB RAM & 256GB SSD Storage – Pre-installed with 8GB DDR4 memory and a fast 256GB M.2 2242 SSD, the G3 S mini desktop offers quicker startup, smoother multitasking, and faster file transfers. Enjoy seamless performance whether you’re working on multiple applications, browsing, or streaming content.
  • Rich Interfaces & Connectivity – The G3 S mini computer comes equipped with USB 3.2 (up to 10Gbps), dual HDMI 2.0 (4K@60Hz), and a 3.5mm audio jack. With support for WiFi 5, Bluetooth 5.0, and Gigabit Ethernet (RJ45 1000MbE), it connects easily with monitors, projectors, printers, office equipment, and other peripherals, making it versatile for both home and business use.
  • Dual 4K Display Support – Featuring upgraded Intel UHD Graphics (up to 1000MHz), the G3 S supports 4K video playback and AV1 decoding for a smooth viewing experience. With dual HDMI outputs, you can connect two 4K@60Hz displays simultaneously, enabling efficient multitasking for work and entertainment.
  • GMKTEC WARRANTY - GMKtec offers a 3-year limited warranty (1 year replacement + 2 years parts replacement) for each mini PC, starting from the date of the purchase effective on all sales starting Oct. 2026. All defects due to design and workmanship are covered. With a professional after sales team always ready to attend to your needs, you can simply relax and enjoy your mini PC

2. Check whether HHVM publishes your suite

The official page does not state that Ubuntu 24.04 is supported. Test the repository path directly, particularly on a new Ubuntu release:

curl -I https://dl.hhvm.com/ubuntu/dists/noble/

Replace noble with the codename printed on your VPS. A response showing that the directory or its metadata is available is a useful indication that the suite is published. A 404 or another repository error means you should not substitute jammy, focal, or an unrelated suite just to make APT proceed; packages built for a different Ubuntu release can create dependency and runtime failures.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

For a non-noble server, perform the same test with its own codename:

CODENAME="$(lsb_release -cs)"
curl -I "https://dl.hhvm.com/ubuntu/dists/${CODENAME}/"

Keep the result with your deployment notes. Repository layouts and supported release lines can change, so repeat this check when rebuilding a VPS rather than assuming that a previously working codename remains available.

3. Become root and install repository helpers

The official Linux procedure is performed as root. Start a root shell with either command:

sudo -i

or:

su -

Install the basic tools needed to identify the release, fetch repository metadata over HTTPS, and manage a signing key:

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
apt update
apt install -y ca-certificates curl gnupg lsb-release

If your image already includes these packages, APT will leave them unchanged. Running apt update here only refreshes Ubuntu’s existing sources; HHVM has not been added yet.

4. Import the HHVM signing key

The official guide shows this keyserver command, using Ubuntu’s keyserver and key ID B4112585D386EB94:

apt-key adv --keyserver keyserver.ubuntu.com --recv B4112585D386EB94

On newer Ubuntu installations, apt-key may print a deprecation warning or fail because the command is no longer available. Do not disable signature checking and do not install packages from an unsigned repository. The HHVM guide documents an alternative key-import method for systems where the keyserver command fails; use that method from the current official instructions rather than copying an unverified key from a third-party page.

After importing the key, you can inspect the local key list to confirm that an HHVM signing key was added:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
apt-key list

If your Ubuntu image has removed apt-key, this inspection command may fail as well; that does not prove the key was absent. The important check is whether the subsequent apt update can authenticate HHVM’s Release metadata. The current documentation’s exact recommendation for a dedicated signed-by keyring on Ubuntu 24.04 is not established here, so follow the live HHVM instructions for that release instead of mixing key-management examples from unrelated repositories.

5. Add the HHVM APT repository

Create an APT source entry using the codename you verified. The repository base is:

https://dl.hhvm.com/ubuntu

For an unpinned installation, the guide’s repository entry uses your Ubuntu suite and the HHVM component. Generate the file with the syntax shown in the current HHVM Linux instructions:

Rank #2
BOSGAME E5 11 Pro Mini PC, AMD Ryzen 5300U 4C/ 8T, Business Home Office PC | 8GB DDR4 256GB M.2 2280 SSD, 2.5 GbE Dual Lan Desktop Computers, Triple Displays 4K 60Hz, Wi-Fi 5, BT 5.0, Support Linux SSH
  • 【AMD Ryzen 3 5300U CPU: Outperforms N150 & 3500U】 BOSGAME E5 mini PC is powered by the TSMC 7nm FinFET architecture AMD Ryzen 3 5300U processor (4 Cores, 8 Threads, up to 3.8GHz boost, 6MB total cache). Compared to low-end Intel N150 or 3500U chips which only have 4 single threads and throttle under load, the 5300U delivers over 30% faster multi-core speed. Run 30+ browser tabs, large Excel sheets, and Zoom meetings simultaneously without system lag.
  • 【8GB DDR4 RAM & 256GB NVMe SSD Storage】 Installed with high-speed 8GB DDR4 dual-channel memory and a fast 256GB M.2 2280 SSD, eliminating slow boot times and application loading delays. To accommodate growing data requirements, the upgradeable hardware design features dual SODIMM slots that allow you to expand memory up to 64GB RAM, ensuring smooth operation during heavy multitasking.
  • 【High-Capacity Dual M.2 SSD Storage Expansion】 Never worry about running out of space for your business files. In addition to the pre-installed 256GB system drive, the motherboard houses an extra empty internal M.2 2280 NVMe PCIe 3.0 slot. This allows you to easily add a second solid-state drive for up to an additional 2TB of storage capacity (upgrades not included) without needing to remove or reinstall the original operating system.
  • 【Radeon 6-Core Graphics & Triple 4K Displays】 Integrated with official AMD Radeon Graphics (6 Graphics Cores, 1500 MHz frequency) for casual gaming, photo editing, and crisp 4K media decoding. Featuring 1x HDMI 2.0 port, 1x DisplayPort, and 1x Full-Function Type-C port, the E5 outputs true 4K@60Hz resolution to three monitors at once. This multi-screen setup eliminates constant window-switching for traders, programmers, and office workers.
  • 【Dual 2.5GbE LAN Ports for Advanced Networking】 Experience fast wired network transmission speeds up to 2500Mbps without lagging or buffering. The integration of dual 2.5 Gigabit Ethernet ports (powered by Realtek RTL8125 controller) makes this compact computer an exceptional hardware choice for tech enthusiasts. Easily configure it into software routers, hardware firewalls (pfSense, OpnSense), home NAS servers, or local homelabs.
CODENAME="$(lsb_release -cs)"
editor /etc/apt/sources.list.d/hhvm.list

Enter the official HHVM deb line, replacing its suite token with ${CODENAME}‘s value. Keeping the entry in its own file makes it easy to audit, disable, or remove later. Do not add both a generic line and a release-pinned line for the same suite; duplicate entries can make package selection difficult to diagnose.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

If you want a specific HHVM release family, include the major.minor token in the repository line exactly as the official guide specifies. For example, a 4.56 target receives later 4.56.x patch releases, but it does not automatically move to the 4.57 line. The token belongs in the repository definition, not as an arbitrary package-name suffix.

Check the resulting file before refreshing APT:

cat /etc/apt/sources.list.d/hhvm.list

Confirm that the URL is https://dl.hhvm.com/ubuntu, that the suite matches lsb_release -cs, and that any major.minor pin is intentional.

6. Refresh APT and install HHVM

Once the source file and signing key are in place, refresh package metadata:

apt update

Read the output rather than ignoring warnings. A successful run should download HHVM repository metadata without a missing-key, missing-Release-file, or unsupported-suite error. Install the main package:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
apt install -y hhvm

The package manager resolves HHVM’s dependencies and places the executable on the system path. If APT proposes removing unrelated software or reports that the repository has no installation candidate, stop and fix the repository configuration instead of accepting a forced change.

7. Verify the installation

Check the executable and the package APT installed:

hhvm --version
dpkg -s hhvm | sed -n '1,12p'
command -v hhvm

hhvm --version should print the installed HHVM version. command -v should return the executable path, normally somewhere under /usr/bin. If the package installation completed but the shell says hhvm: command not found, start a new shell and inspect the path returned by command -v; do not immediately download a second binary.

Which HHVM package should you install?

The repository contains more than the runtime. Choose the package that matches the task on the VPS:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Package Use
hhvm The standard HHVM runtime and the package used by the official installation procedure.
hhvm-dbg Debugging symbols for the corresponding HHVM build.
hhvm-dev Development files for work that needs HHVM’s development interfaces.
hhvm-nightly A nightly runtime build rather than the regular package line.
hhvm-nightly-dbg Debugging symbols for the nightly build.
hhvm-dev-nightly Development files associated with nightly builds.

Install hhvm first unless you have a specific debugging, development, or nightly-build requirement. Nightly packages can change more frequently than a pinned stable major.minor line, so record the exact package and repository entry used for a reproducible deployment.

How version pinning works

HHVM’s repository selector distinguishes a major.minor release family from an individual patch. When the repository line targets a family such as 4.56, patch updates in that family arrive through normal APT updates. A later minor family, such as 4.57, does not arrive automatically. This gives you a practical balance: security and bug-fix patches can be consumed without silently crossing a minor-version boundary.

Before changing the pin, inspect what APT sees:

apt-cache policy hhvm

Change the repository entry, refresh metadata, and review the proposed candidate before upgrading:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
apt update
apt-cache policy hhvm
apt install --only-upgrade hhvm

The exact available versions depend on what HHVM publishes at the time you run these commands. The official documentation gives 4.56.1 as an example of a patch release; it is not a statement that this is the current release on your VPS.

Rank #3
Glorlin Mini PC Ryzen 7 8745HS, Mini Desktop Computer 16GB DDR5 RAM 1TB SSD, Radeon 780M, 4X 4K Display, USB4, Dual 2.5G LAN, WiFi 6, BT5.3, Mini Gaming PC for Office, Programming, Home Server
  • 【1-Year Worry-Free Warranty】Your satisfaction is our priority. Glorlin provides a 1-year warranty covering any hardware malfunctions. We support returns or exchanges to ensure a 100% worry-free shopping experience. Have a question? Reach out to us through our official after-sales email for a prompt solution.
  • 【Reliable Performance with Ryzen 7 Processor】Powered by AMD Ryzen 7 8745HS (8 cores, 16 threads, up to 4.9GHz), this mini pc delivers stable performance for daily workloads. Suitable for office tasks, programming, and multitasking, it works well as a ryzen mini pc for both home and business use.
  • 【Radeon 780M Graphics for Media and Light Gaming】Equipped with integrated Radeon 780M graphics, this mini gaming pc supports smooth 4K video playback and handles many popular games at adjusted settings. A practical mini computer for media, editing, and casual gaming.
  • 【Mini PC 16GB RAM and Fast Storage】This mini pc 16gb ram configuration includes single 16GB DDR5 memory (4800MHz,3GB is assigned to VRAM by default) and a 1TB NVMe SSD, offering quick boot times and responsive system performance. Dual M.2 slots allow storage expansion up to 4TB for growing files and projects.
  • 【Quad 4K Display Support for Productivity】The mini desktop computer supports up to four 4K displays via HDMI, DisplayPort, and dual USB-C ports. Ideal for multi-screen workflows such as coding, trading, or content creation with improved efficiency.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Ubuntu 24.04 (noble): choose the correct branch

If the noble suite exists

Use noble in the HHVM source entry, keep the signing-key configuration supported by the current guide, and run apt update. Install only after APT downloads a valid HHVM Release file and presents an installation candidate. Verify with hhvm --version.

If the noble suite is missing

Do not point a 24.04 system at an older Ubuntu suite. The package may install while carrying incompatible libraries, and future updates can become impossible to resolve. Keep Ubuntu 24.04 and select an alternative deployment method:

  • Run the official HHVM Docker image and isolate the runtime from the host’s APT sources.
  • Build HHVM from source only if your distribution is one for which HHVM documents builds and the VPS has several gigabytes of available RAM.

A community script that builds nightly packages for Ubuntu 24.04 is not an official support path. Treat it as an independent project, audit its contents, and do not rely on it for a production installation without accepting its maintenance and supply-chain risks.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Troubleshooting common installation failures

apt update reports “does not have a Release file”

The suite is probably not published at the configured path, or the codename is misspelled. Re-run lsb_release -cs and test the matching directory with curl -I. If the directory is unavailable, remove or disable the HHVM source file and use Docker or a supported source build. Do not solve this by changing noble to an arbitrary older suite.

APT reports NO_PUBKEY or an unsigned repository

The signing key was not imported in a way APT can use, or the key has changed. Recheck the key ID B4112585D386EB94 against the current HHVM instructions and use the documented alternative when apt-key adv fails. Never bypass signature verification with insecure APT options.

There is no installation candidate for hhvm

Inspect the source file and run:

apt-cache policy hhvm

No candidate generally means that APT did not load the HHVM repository, the suite is unsupported, or the repository line’s release selector is malformed. Correct the source and run apt update again before trying to install.

The shell says hhvm: command not found

Confirm that apt install hhvm completed successfully, then run dpkg -L hhvm | grep '/hhvm$' to locate the binary. Start a new login shell if the executable directory was added after your current session began. If the package is absent, return to apt-cache policy hhvm and fix APT rather than copying a binary from another server.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

The keyserver command cannot connect

Outbound keyserver traffic is often restricted on VPS networks. Check DNS and HTTPS connectivity, then use the alternative key-import procedure in the official HHVM guide. A transient keyserver failure is not a reason to trust an unverified download.

Using Docker or a source build instead

Docker

The official Docker option is the cleanest fallback when your Ubuntu codename has no APT suite. It keeps HHVM’s userspace and dependencies in the image, while the VPS remains on its normal Ubuntu repositories. Use the official HHVM Docker documentation for the image name, tags, volume layout, and application-server integration; those details vary by image version and are not interchangeable with an APT installation.

Source compilation

HHVM’s build documentation limits supported source builds to distributions for which HHVM makes binaries and warns that compilation needs several gigabytes of RAM. A small VPS can fail during compilation even when the source tree is correct. Add temporary swap only if your provider and operating policy allow it, and remove it or resize the server after the build if it was created solely for compilation. A source build also becomes your responsibility to package, update, and remove, unlike an APT-managed installation.

Updating, auditing, and removing HHVM

After installation, keep the repository entry and selected major.minor family documented with the VPS configuration. To see whether a patch update is available:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
apt update
apt-cache policy hhvm

Apply an update only after reviewing the candidate version:

apt install --only-upgrade hhvm

To remove the runtime while retaining configuration files, use:

apt remove hhvm

To remove the package and its system configuration files, use apt purge hhvm after confirming that no application still depends on it. Remove /etc/apt/sources.list.d/hhvm.list only when you are finished with the HHVM repository; otherwise future package operations may continue querying it.

Final installation checklist

  • lsb_release -cs matches the suite in the HHVM source entry.
  • The matching path under https://dl.hhvm.com/ubuntu/dists/ responds before installation.
  • The HHVM signing key is installed using the official documented method.
  • apt update completes without signature or Release-file errors.
  • apt install hhvm selects an actual candidate.
  • hhvm --version prints the runtime version.
  • Any major.minor pin is recorded, so routine APT updates cannot unexpectedly cross into the next minor line.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More quests from Patch Notes

  1. How to Set Up a RedM (RDR2) Server in 2026: License Key, txAdmin and server.cfg, Step by StepBlog11min
  2. Best RedM (RDR2) Server Hosting in 2026: Comparing Four Hosts on Slots, Memory and PriceBlog10min
  3. How to Host a Mindustry Server in 2026: server-release.jar, Port 6567 and the Commands That MatterBlog7min
Recommended PC Tool
Recommended PC Tool
Outdated Drivers Are Slowing You DownFree scan - exact matches
PC Slower Than It Used to Be?Free scan - under a minute

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.