ServeUP

Your next shift
starts here.

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 installation

How will you use ServeUP?

Choose the setup that matches your device.

Complete POS system

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.

For Intel or AMD 64-bit devicesReplaces the operating system on the target drive
Create a ServeOS USB
Keep your existing OS

Install ServeUP POS for Linux

Add the ServeUP POS app to a compatible Linux desktop. Our installer sets up the repository, app and required packages.

Currently supports Ubuntu 22.04 LTS x64Keeps your operating system and files
Install on Linux

Setting up a till from scratch? Choose ServeOS. Already running a supported Linux desktop? Choose the POS app.

Start with
a USB.

Download 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 steps

ServeUP USB Creator

Choose the computer preparing your USB.

macOS 14 or later. Find your processor in the Apple menu under About This Mac.

Download for Apple Silicon
macOS disk imageVersion 0.1.4 / Build 13.1

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.

All downloads and checksums

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.

Your Linux.
Your ServeUP.

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.

Stable release

Recommended

Open Terminal on your POS device. Paste the command and enter your administrator password when prompted.

Terminal
wget -O serveup-install.sh https://install.serveup.software/install.sh && sudo bash serveup-install.sh

Once installation finishes, open ServeUP POS from your applications menu.

Beta release

Use the beta channel only on a device you use for testing.

Terminal
wget -O serveup-install.sh https://install.serveup.software/install.sh && sudo bash serveup-install.sh --channel=beta
Read the installer script

Manual installation

Can I download the Debian package separately?

Yes. 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.

I only need to configure the repository.

For managed deployments, this command adds the key and repository without installing the POS.

Terminal
wget -O serveup-install.sh https://install.serveup.software/install.sh && sudo bash serveup-install.sh --repository-only

After setup, install by name with sudo apt install serveup-pos or sudo apt install serveup-pos-beta.

How is the download verified?

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 key
See what runs on your machineInside the installerView source

The complete script behind the install command. Read it here or download a copy to review before running it in Terminal.

install.shBash
Download script
#!/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'

From download
to your counter.

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.

  1. 1

    Create your installation USB

    Open USB Creator, select your USB drive and confirm. The app downloads ServeOS, writes the image and verifies the result.

  2. 2

    Start your POS device from the USB

    Safely remove the USB, connect it to your POS device and select it from the device's boot menu.

  3. 3

    Follow the ServeOS installer

    Choose the target drive and complete setup. When installation finishes, remove the USB and restart your device.

More ways to
run ServeUP.

Desktop POS apps for your existing Windows and Mac computers are on the way.

ServeUP POS for Windows

Windows 10 and 11

Coming soon

ServeUP POS for Mac

Intel and Apple Silicon

Coming soon

USB Creator is already available for these computers. These upcoming apps will run the POS directly on Windows and macOS.

A little help
getting started.

Choose the right setup and know what happens before you install.

Contact ServeUP
What's the difference between ServeOS and ServeUP POS?

ServeOS is a complete operating system for a dedicated POS device. The Linux installer adds the ServeUP POS app to an existing supported operating system.

Does the Mac download install ServeOS on my Mac?

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.

Will this erase my files?

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.

Can I use another Debian-based distribution?

The current POS installer supports Ubuntu 22.04 LTS x64. Debian-based does not always mean compatible. Check the supported version before installing.

Do I need an internet connection?

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.

What should I check before installing?

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.