Set up with ServeOS
A complete operating system for a dedicated ServeUP POS device. Start with a USB installer and follow the setup on your till.
A new home for your POS, or an app for the Linux system you already use. Choose how you want to install ServeUP.
Choose your installationDownload USB Creator on the computer you're using now. It downloads ServeOS, writes it to your USB drive and checks that the USB is ready.
Your computer prepares the USB. ServeOS installs on your Intel or AMD POS device.
See the installation stepsChoose the computer preparing your USB.
macOS 14 or later. Find your processor in the Apple menu under About This Mac.
Windows 64-bit
For Windows 10 and Windows 11 on an Intel or AMD computer.
Linux 64-bit
Debian package for compatible Intel or AMD Linux desktops.
Creates your USB with the latest production ServeOS installer.
This Mac build is not notarized. If macOS blocks it, review the app in System Settings under Privacy & Security and choose Open Anyway.
USB Creator 0.1.4, build 13.1. Mac builds use ad-hoc signatures and are not notarized. The Windows build is unsigned. Linux is available as a Debian package.
Install the POS app on your existing Ubuntu desktop. One command sets up the official repository and installs the app with its dependencies.
Ubuntu 22.04 LTS desktop on an Intel or AMD 64-bit device. Other distributions and ARM devices are not supported by this installer yet.
Open Terminal on your POS device. Paste the command and enter your administrator password when prompted.
wget -O serveup-install.sh https://install.serveup.software/install.sh && sudo bash serveup-install.shOnce installation finishes, open ServeUP POS from your applications menu.
Use the beta channel only on a device you use for testing.
wget -O serveup-install.sh https://install.serveup.software/install.sh && sudo bash serveup-install.sh --channel=betaYes. First run the repository-only command below so APT can find the Crossmatch driver and verify repository metadata. Download the release you need, then install the local file with sudo apt install ./filename.deb.
For managed deployments, this command adds the key and repository without installing the POS.
wget -O serveup-install.sh https://install.serveup.software/install.sh && sudo bash serveup-install.sh --repository-onlyAfter setup, install by name with sudo apt install serveup-pos or sudo apt install serveup-pos-beta.
The installer checks the ServeUP public-key fingerprint before adding the repository. APT verifies the signed repository metadata and the package checksums it contains.
E54A 85CB B1B9 E919 3C8D 2A0E DD03 1DD9 3A4A 1807
Download the public signing keyThe complete script behind the install command. Read it here or download a copy to review before running it in Terminal.
#!/usr/bin/env bash
# Bootstrap the signed ServeUP repository on Ubuntu 22.04 amd64.
set -euo pipefail
channel=stable
repository_only=false
for arg in "$@"; do
case "$arg" in
--channel=stable|--channel=beta|--channel=dev) channel=${arg#*=} ;;
--repository-only) repository_only=true ;;
--help|-h)
printf 'Usage: sudo bash install.sh [--repository-only] [--channel=stable|beta|dev]\n'
exit 0 ;;
*) printf 'Unknown option: %s\n' "$arg" >&2; exit 2 ;;
esac
done
if [[ $(id -u) != 0 ]]; then
printf 'Run this downloaded script with sudo bash.\n' >&2
exit 1
fi
source /etc/os-release
if [[ ${ID:-} != ubuntu || ${VERSION_ID:-} != 22.04 || $(dpkg --print-architecture) != amd64 ]]; then
printf 'This installer currently supports Ubuntu 22.04 on x64 only. No changes made.\n' >&2
exit 1
fi
work=$(mktemp -d)
trap 'rm -rf "$work"' EXIT
umask 022
mkdir -m 700 "$work/gnupg"
printf 'Preparing ServeUP repository setup...\n'
if ! command -v curl >/dev/null || ! command -v gpg >/dev/null || ! dpkg-query -W -f='${Status}' ca-certificates 2>/dev/null | grep -q 'install ok installed'; then
apt-get update
apt-get install -y --no-install-recommends ca-certificates curl gnupg
fi
curl --proto '=https' --tlsv1.2 --fail --show-error --silent --location \
--connect-timeout 15 --max-time 120 \
https://repo.serveup.software/repo.pub -o "$work/key.asc"
fingerprints=$(gpg --homedir "$work/gnupg" --batch --show-keys --with-colons "$work/key.asc" | \
awk -F: '$1=="pub" {primary=1; next} $1=="fpr" && primary {print $10; primary=0}')
if [[ "$fingerprints" != E54A85CBB1B9E9193C8D2A0EDD031DD93A4A1807 ]]; then
printf 'ServeUP signing key verification failed. Repository was not added.\n' >&2
exit 1
fi
gpg --homedir "$work/gnupg" --batch --dearmor --output "$work/serveup.gpg" "$work/key.asc"
install -d -m 755 /etc/apt/keyrings
install -m 644 "$work/serveup.gpg" /etc/apt/keyrings/serveup.gpg
cat > "$work/serveup.sources" <<'SOURCES'
Types: deb
URIs: https://repo.serveup.software
Suites: jammy
Components: main
Architectures: amd64
Signed-By: /etc/apt/keyrings/serveup.gpg
SOURCES
install -m 644 "$work/serveup.sources" /etc/apt/sources.list.d/serveup.sources
# Accept the documented Ubuntu-to-ServeUP branding change for this source only.
apt-get update --allow-releaseinfo-change-origin --allow-releaseinfo-change-label \
-o Dir::Etc::sourcelist=/etc/apt/sources.list.d/serveup.sources \
-o Dir::Etc::sourceparts=- -o APT::Get::List-Cleanup=0 \
-o APT::Update::Error-Mode=any
printf 'ServeUP signing key and repository are configured.\n'
if "$repository_only"; then exit 0; fi
package=serveup-pos
if [[ "$channel" != stable ]]; then package="serveup-pos-$channel"; fi
candidate=$(apt-cache policy "$package" | awk '/Candidate:/ {print $2}')
if [[ -z "$candidate" || "$candidate" == '(none)' ]]; then
printf 'The %s installer package has not been published yet. Repository setup is complete.\n' "$channel" >&2
printf 'Once released, run: sudo apt update && sudo apt install %s\n' "$package" >&2
exit 3
fi
apt-get update
apt-get install -y "$package"
printf 'ServeUP POS is installed. Open it from your application menu.\n'
You'll need a USB drive large enough for the ISO, an internet connection and administrator access on the computer preparing it.
USB Creator erases the selected USB drive. Installing ServeOS also erases the target drive on your POS device. Back up the files you need first.
Open USB Creator, select your USB drive and confirm. The app downloads ServeOS, writes the image and verifies the result.
Safely remove the USB, connect it to your POS device and select it from the device's boot menu.
Choose the target drive and complete setup. When installation finishes, remove the USB and restart your device.
Desktop POS apps for your existing Windows and Mac computers are on the way.
Windows 10 and 11
Intel and Apple Silicon
USB Creator is already available for these computers. These upcoming apps will run the POS directly on Windows and macOS.
Choose the right setup and know what happens before you install.
Contact ServeUPServeOS is a complete operating system for a dedicated POS device. The Linux installer adds the ServeUP POS app to an existing supported operating system.
No. USB Creator runs on your Mac and prepares a USB installer for an Intel or AMD POS device. ServeOS does not currently support Apple Silicon as an installation target.
USB Creator erases only the USB drive you select. The ServeOS installer erases the target drive you choose on your POS device. Installing the POS app on Ubuntu keeps the existing operating system and files.
The current POS installer supports Ubuntu 22.04 LTS x64. Debian-based does not always mean compatible. Check the supported version before installing.
USB Creator needs an internet connection to fetch the installer image. The Ubuntu POS installer needs one to download its packages. You will also need connectivity to set up your ServeUP account and store.
Confirm that your device meets the requirements for your chosen installation. Have administrator access, a backup of important files, and your ServeUP account and store details ready.