Hardware FixRecommendedDevice not working? Your driver may be the problemCheck updates for common hardware issues.Fix DriversOctober DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsSlow PC?RecommendedPC slow today? Run a repair scan before it gets worseResolve common Windows issues and optimize system performance.Scan Now×
Skip to content
AArch64

How to Install and Run wkhtmltopdf on ARM64 (aarch64)

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

On a 64-bit ARM Debian or Ubuntu system, install wkhtmltopdf with sudo apt update && sudo apt install wkhtmltopdf. The repositories for Ubuntu Noble and Debian Bookworm provide native arm64 packages, so you normally do not need emulation or an x86_64 binary. First confirm that the machine, operating-system release and package architecture match; then run a local conversion test and a URL test.

What ARM64 support means

Linux usually reports 64-bit ARM as aarch64, while Debian-family package metadata uses arm64. They describe the same 64-bit ARM instruction set for this purpose. The upstream wkhtmltopdf 0.12.6 release added 64-bit ARM support, and the packaging project publishes distribution-specific ARM64 or aarch64 artifacts.

Do not confuse ARM64 with armhf (32-bit ARM) or amd64/x86_64 (64-bit Intel and AMD). A package can be valid but still unusable if it targets a different CPU or a different operating-system release.

1. Confirm the host before installing

Run these commands on the machine where wkhtmltopdf will execute:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
#1 Best Overall
Libre Computer Le Potato Mini Single Board Computer with USB WiFi 4 and Heatsink (2GB WiFi 4, Libre Blue)
  • AML-S905X-CC WITH HEATSINK AND WIFI: Le Potato is a powerful SBC platform capable of handling many computing tasks while consuming less than a watt. This bundle adds a bespoke heatsink and plug and play WiFi dongle for getting the most from your board.
  • BESPOKE ANODIZED HEATSINK: The anodized heatsink provides a protective oxide layer that resists environmental corrosion while offering significantly better thermal performance. Dramatically increase sustained performance while increasing reliability via reduced temperature cycling. Two push pin anchors securely attach heatsink for vibration resistance.
  • PLUG AND PLAY USB WIFI: Get a no-hassle WiFi dongle that offers great performance and feature set including AP mode, ad-hoc mode, monitor mode, packet injection, and more. It is fully integrated into the Linux kernel and is perfect for embedded applications that require low power consumption, memory usage, and software support.
  • ADDITIONAL PERIPHERALS REQUIRED: MicroSD card or eMMC flashed with the correct image. Proper bootloader or image is required to have HDMI video output. The green LED will turn on once the bootloader is detected. Please use a 5V 2A or higher MicroUSB power supply. Power supplies with insufficient power will experience voltage drops that cause instability and random application crashes or boot issues. For additional assistance, please use hub.libre.computer for guides and end-user support.
  • PERIPHERAL COMPATIBILITY: Most USB based peripherals are directly supported. The GPIO header maintains the same layout for hardware I2C, SPI, PWM, and UART compatibility. I2S, PCM, and SDIO do not share the same pins so most audio peripherals will need to be re-routed. Le Potato features additional GPIOs and SARADC pins on separate headers.
uname -m
# Expected on a 64-bit ARM host: aarch64
. /etc/os-release
printf '%s %sn' "$ID" "$VERSION_ID"

If uname -m prints x86_64, this is not an ARM64 installation; follow the x86_64 package instructions for that host. Record the ID and VERSION_ID values because an Ubuntu package should not be mixed with Debian libraries, and a package for one Ubuntu release may not be suitable for another.

2. Preferred method: install the distribution package

For Debian or Ubuntu ARM64, use the operating system’s package manager:

sudo apt update
sudo apt install wkhtmltopdf

Ubuntu Noble lists wkhtmltopdf_0.12.6-2build2_arm64.deb; Debian Bookworm publishes wkhtmltopdf_0.12.6-2+b1 for arm64. The exact revision can differ by release. The package-manager route is preferred because apt selects dependencies for the installed release, records the files in the package database and receives normal distribution updates. Ubuntu’s package guidance specifically recommends using a package manager rather than downloading a package manually.

Ubuntu repository availability

On Ubuntu, the package is in the universe component. If apt reports no candidate, check that the component is enabled, refresh indexes and try again:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
sudo add-apt-repository universe
sudo apt update
apt-cache policy wkhtmltopdf
sudo apt install wkhtmltopdf

The apt-cache policy output should show a candidate version. If it remains empty, verify the release reported by /etc/os-release and the configured sources before trying a third-party file.

Debian repository availability

On Debian Bookworm, the archive contains a native arm64 build. Use the same apt commands and let apt choose the Bookworm dependency versions. Avoid copying libraries from another Debian release to make a manually downloaded binary start.

3. When an upstream artifact is appropriate

Use an upstream packaging artifact only when the distribution build is unavailable or lacks a feature you require. The packaging releases include a Bookworm arm64 .deb and aarch64 RPMs for AlmaLinux; its build matrix also defines ARM64 targets for Debian and Ubuntu and aarch64 targets for Amazon Linux and openSUSE. Select the file whose operating system, release and architecture exactly match your host.

Rank #2
Sale
BOSGAME E4 Air Mini PC, AMD Ryzen 5 3500U 8GB DDR4 256GB SATA SSD
  • 【Ryzen 5 3500U Processor】The BOSGAME mini pc is driven by the Ryzen 5 3500U (4C/8T, up to 3.7GHz) , with integrated Radeon Vega 8 Graphics, delivering reliable power, 4K video streaming and multitasking. Handle daily workloads like spreadsheet calculations, web browsing, and HD video editing effortlessly.
  • 【8GB DDR4 & 256GB SATA SSD】E4 Air mini computers with 8GB DDR4 RAM and a 256GB SATA SSD, this mini desktop ensures quick app launches and efficient multitasking. while the SSD accelerates file transfers—ideal for office documents, media storage, and everyday computing.
  • 【4K Triple Display & USB-C & USB3.2】The mini desktop computer Drives three 4K monitors via HDMI, DisplayPort and USB-C for multi-window productivity or immersive home theater setups;USB 3.2 meets your multi-interface transfer needs.
  • 【Dual RJ45 LAN & Wi-Fi 5 & BT5.0】Equipped with Dual Gigabit Ethernet, dual-band Wi-Fi 5, and Bluetooth 5.0, this ryzen mini pc ensure stable connections for 4K streaming, video calls, and file transfers. Wirelessly connect keyboards, headphones and speakers via BT5.0 ideal for office productivity and home entertainment.
  • 【3-Year Reliable Customer Services】 All of our BOSGAME mini pc gaming have FCC, ROHS, CE certifications. BOSGAME enjoy a 1-year wa-rranty for the entire machine and a 3-year wa-rranty for parts, ensuring your long-term peace of mind. If you have any questions about your purchase, please let us know through Amazon.

Inspect a Debian package before installing

After downloading the exact file supplied for your release, inspect its metadata:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
dpkg-deb -I ./wkhtmltox_*_arm64.deb | sed -n '1,20p'

Check the architecture, package version and dependency fields. Install a local Debian package through apt, not by forcing dpkg alone, so dependencies can be resolved:

sudo apt install ./wkhtmltox_*_arm64.deb

Replace the wildcard with the actual filename when more than one artifact is present. Never substitute an amd64, armhf or unrelated-release file. For RPM-based systems, use the matching aarch64 package and the system’s RPM tooling; do not mix Debian and RPM packages.

Provenance and reproducibility

Record the download URL, checksum, package version, distribution release and architecture in deployment notes. The upstream release and packaging repositories are archived, so pinning the artifact that worked is important for repeatable builds. The packaging release page shows later 0.12.6.1-3 artifacts, including Bookworm arm64 and AlmaLinux aarch64 packages, with that build published in May 2023; your repository may provide a different revision.

4. Verify the executable and perform a real conversion

Installation is not complete until the binary can create a readable document. Check its path and version first:

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.
command -v wkhtmltopdf
wkhtmltopdf --version

Then run a network-independent smoke test. It isolates installation and font problems from DNS, TLS and firewall problems:

cat > /tmp/wkhtmltopdf-smoke.html <<'EOF'
<!doctype html>
<html>
  <body>
    <h1>ARM64 smoke test</h1>
    <p>wkhtmltopdf works.</p>
  </body>
</html>
EOF
wkhtmltopdf /tmp/wkhtmltopdf-smoke.html /tmp/wkhtmltopdf-smoke.pdf
file /tmp/wkhtmltopdf-smoke.pdf

A successful run leaves a PDF at /tmp/wkhtmltopdf-smoke.pdf; file should identify it as a PDF document. Open it with a PDF viewer or copy it from the server to confirm that the heading and paragraph render.

Rank #3
GMKtec M6 Ultra Gaming Mini PC Ryzen 7640HS (Upgraded 6600H/ 6800H), 32GB RAM DDR5 512GB SSD Dual NIC LAN 2.5GbE Desktop Computers Office Home, Triple 4K Display, WiFi 6, USB4, BT 5.2, DP, HDMI 2.0
  • VALUE & PERFORMANCE MINI PC - GMKtec Nucbox M6 Ultra Series is equipped with the powerful AMD Ryzen 5 7640HS processor. This CPU is an upper mid-range processor (APU) of the Phoenix product family. It has 6 SMT-enabled Zen 4 cores (12 threads) running at 4.3 GHz base speed to turbo boost 5.0 GHz.With a TDP Boost of 45W-60W, the Ryzen 7640HS CPU is more energy efficient and delivers a 30% Performance increase over previous AMD Ryzen 7 6800H, 6600U.
  • 32GB DDR5 RAM & 512GB PCIe SSD - Installed with DDR5 32GB RAM SO-DIMM Dual Channel (2x16GB), the Nucbox M6 Ultra mini pc support expansion to 128GB RAM. Featured with 512GB M.2 2280 PCIe 3.0 SSD, support dual slot expansion to PCIe 4.0 8TB SSD. (Upgrades not included)
  • GAMING PC - The Radeon 760M iGPU has 8 CUs (512 shaders) running at up to 2,600 MHz. This desktop computer can play moderate gaming at a steady FPS, it also HW-encodes and HW-decodes the most widely used video codecs such as AV1, HEVC and AVC.
  • DUAL NIC LAN 2.5G RJ45 - Fast Network Speeds: Enjoy up to 2500Mbps data transmission speed without worrying about lagging. Ideal for working, gaming, and surfing the internet. Great for Untangle, Pfsense or as a server office PC.
  • TRIPLE 4K DISPLAY - Unlock unparalleled productivity with support for three simultaneous displays, including a stunning 8K@60Hz via USB4, plus 4K@60Hz through both HDMI 2.0 and DisplayPort, transforming your workspace into a command center for multitasking and immersive entertainment.

Test a live URL separately

wkhtmltopdf https://example.com example.pdf

A URL conversion exercises DNS, outbound HTTPS, certificates, redirects, JavaScript timing and the target site’s access policy. If network access is restricted, the local-file test remains the valid installation check.

How wkhtmltopdf processes input

Debian describes wkhtmltopdf as a command-line converter that accepts a URL, a local HTML file or standard input and writes a PDF or image. The executable is therefore suitable for scripts, queues and service workers, but those environments must provide the same fonts, permissions and network access as an interactive shell.

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

Troubleshooting ARM64 installations

“Package ‘wkhtmltopdf’ has no installation candidate”

Confirm the distribution and release, ensure the repository component containing the package is enabled (Ubuntu’s package is in universe), then run sudo apt update. If the archive for that release genuinely does not publish ARM64, choose a matching upstream artifact rather than an x86_64 download.

“Wrong architecture” or an unstartable binary

Run uname -m and inspect the file with dpkg-deb -I. The host should report aarch64 and the Debian package should say Architecture: arm64. Obtain an artifact for the same release. An amd64 binary cannot be made native by renaming it, and an armhf package is 32-bit.

Missing shared libraries

A manually copied binary often fails because runtime libraries are absent. Remove that copy and install the distribution package, or run sudo apt install ./package.deb for a local artifact. Debian-family packaging lists dependencies such as fontconfig, FreeType, X11 libraries, font packages and zlib. Let apt choose versions instead of copying libraries from another release.

Blank pages or missing characters

Install fonts appropriate to the document and repeat the local-file test with the required characters. Rendering depends on the fonts installed on the operating system; the packaging dependency set includes font packages, but a document may still require additional language fonts. Compare the generated PDF on the same host where the command runs.

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

Permission or output errors

Write to a directory the invoking user can modify and use an absolute output path while diagnosing:

Rank #4
BOSGAME E5 Plus Mini PC Ryzen 5400U, 8GB Upgradable RAM 256GB SATA SSD
  • 【AMD Ryzen 5400U 4-Core Performance】Powered by the AMD Ryzen 3 5400U processor with 4 cores, 8 threads, a 2.6GHz base clock and up to 4.0GHz boost clock, the BOSGAME E5 Plus Mini PC delivers responsive performance for everyday computing, office applications, web browsing, video conferencing and multitasking. Integrated AMD Radeon Graphics up to 1600MHz provides smooth visuals for daily work and entertainment.
  • 【Expandable Up to 64GB RAM + Flexible Dual M.2 Storage】Start with 8GB DDR4 memory for everyday computing and expand the E5 Plus Mini Computers up to 64GB through two SODIMM slots as your multitasking needs grow. The included 256GB M.2 2280 SATA SSD provides fast storage for daily applications, while an additional M.2 2280 NVMe PCIe 3.0 x4 slot lets you easily add more high-speed storage for documents, media, software and larger workloads. Flexible memory and storage expansion make this compact PC easy to upgrade for future needs.
  • 【Dual 2.5GbE LAN, Wi-Fi 5 and Bluetooth 5.0】Two 2.5 Gigabit Ethernet ports powered by RTL8125 controllers provide the E5 Plus Mini PC Ryzen with fast and stable wired networking for office networks, file transfers and dual-LAN applications. Wi-Fi 5 supports 802.11 a/b/g/n/ac wireless connectivity, while Bluetooth 5.0 makes it easy to connect keyboards, mice, headphones and other wireless accessories.
  • 【Triple 4K@60Hz Display Outputs】Expand your workspace across multiple screens with HDMI 2.0, DisplayPort and USB Type-C video outputs, each supporting resolutions up to 4K@60Hz. With flexible triple-display connectivity, the E5 Plus Mini PC is ideal for spreadsheets, browser windows, dashboards, video playback and multi-monitor productivity in home offices and business environments.
  • 【Full-Function USB-C and Versatile Connectivity】The full-function USB Type-C port supports data transfer, DisplayPort video output and PD 3.0 functionality. The E5 Plus Ryzen Mini PC also features two front USB 3.2 Gen 2 Type-A ports delivering transfer speeds up to 10Gbps, while two additional USB 2.0 ports and a 3.5mm combo audio jack provide convenient connectivity for everyday peripherals. Supports Windows 11 and Ubuntu for flexible home, office and business deployment.
mkdir -p "$HOME/wkhtmltopdf-test"
wkhtmltopdf /tmp/wkhtmltopdf-smoke.html "$HOME/wkhtmltopdf-test/result.pdf"
ls -lh "$HOME/wkhtmltopdf-test/result.pdf"

In a service, also check the service user’s home, temporary-directory policy and mandatory access controls.

Different behavior after an upgrade

Capture wkhtmltopdf --version, ID/VERSION_ID, package origin and artifact checksum. Distribution revisions and upstream packaging builds can differ in patched Qt behavior, fonts and dependencies. Pin the known-good package in production and retest after changing the base image or operating-system release.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Choosing between installation methods

Choice Best use Dependency handling Main risk
Distribution apt package Most Debian and Ubuntu ARM64 systems Resolved for the installed release Repository may omit a feature or release
Matching upstream .deb Repository unavailable or a required patched build Apt resolves dependencies when installed with apt install ./file.deb Wrong release or architecture selection
Manual binary copy Generally avoid None Missing libraries, fonts and irreproducible behavior

Operational notes for production

  • Pin both the operating-system release and wkhtmltopdf package revision in images or provisioning scripts.
  • Keep the local HTML smoke test in deployment checks; add a URL test only where outbound networking is intentional.
  • Use absolute input and output paths in services, and ensure the service account can read assets and write the destination.
  • Log the version, exit status and output file size. A zero exit status should be paired with a file-opening check.
  • Install the fonts your documents need, especially when generating multilingual invoices or reports.

Or skip the browser setup

If your goal is simply to obtain a clean screenshot or PDF from a URL, ScreenshotNeo provides a hosted alternative to maintaining an ARM64 browser stack. Its API accepts one GET request and returns PNG, JPEG, WebP or PDF. Before capture it accepts cookie or consent banners like a visitor and removes more than 60 known consent platforms, newsletter popups and chat widgets; each cleanup step can be disabled. Bot checks, CAPTCHAs, blank pages, timeouts, failed loads and cache hits are not billed, and response headers identify the page verdict and billing status.

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

Use the API documentation at https://screenshotneo.com/docs/ for all options. A minimal PDF or image request can be made with cURL:

curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webp

The same request in Python:

import requests
r = requests.get("https://api.screenshotneo.com/v1/shot", params={"access_key": "YOUR_API_KEY", "url": "https://stripe.com"}, timeout=90)
r.raise_for_status()
open("shot.webp", "wb").write(r.content)

And Node.js:

const q = new URLSearchParams({ access_key: 'YOUR_API_KEY', url: 'https://stripe.com' });
const res = await fetch(`https://api.screenshotneo.com/v1/shot?${q}`);
if (!res.ok) throw new Error(`${res.status} ${res.statusText}`);
const data = Buffer.from(await res.arrayBuffer());
await import('node:fs/promises').then(fs => fs.writeFile('shot.webp', data));

ScreenshotNeo also offers full-page capture with lazy images, CSS-selector element capture, dark mode, device presets and custom viewports, retina scale, PDF paper and margin controls, custom CSS and JavaScript, clicks, selector or network-idle waits, ad/tracker/request blocking, headers, cookies, user agents, authorization, timezone and geolocation, transparent backgrounds, resizing, configurable-TTL caching, signed links, asynchronous webhooks, bulk capture of up to 100 URLs per call, a usage API and an OpenAPI specification. An MCP server exposes take_screenshot, get_page_info and capture_pdf to Claude, Cursor and other MCP clients.

The Free plan includes 1,000 screenshots per month with no card. Paid plans start at $5 for 3,000 shots; every feature is available on every plan. Create a free ScreenshotNeo account to try it without installing a browser.

Frequently Asked Questions

Does ARM64 require an emulator to run wkhtmltopdf?

No. Native arm64 packages are available for common Debian and Ubuntu releases, including Debian Bookworm and Ubuntu Noble.

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.

Can I use an Ubuntu ARM64 package on Debian?

Do not mix them by default. Choose a package built for the exact distribution and release so its libraries and dependency metadata match the host.

What is the quickest installation check?

Run wkhtmltopdf --version, convert a local HTML file to a PDF, and inspect the result with file.

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.

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.

Read next

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.