Repository navigation
NanoPi Zero2 DietPi
Run the engine on a palm-sized single-board computer that sits on the LAN all day, so phones, televisions and players can use it as a remote engine. The reporter ran it as a systemd service on a FriendlyElec NanoPi Zero2 with DietPi, and posted the unit's settings in reply to the OpenWrt Router story.
| Report | Details |
|---|---|
| Source | 4PDA forum, Ace Stream [Android] thread, post of 2026-11-17 |
| Reported by | 4PDA user MediaStream66 |
| Versions | Not stated. Posted two days after v1.2.1; use 1.0.0 or later. |
| Device | FriendlyElec NanoPi Zero2 (the post spells it "Zepo2"). The board has a Rockchip RK3528A, four 64-bit ARM Cortex-A53 cores, and 1 GB or 2 GB of RAM; the post doesn't say which. |
| OS | DietPi, latest build at the time (DietPi is Debian-based) |
| Players | Not stated |
| Works on | Any Debian-based single-board computer or small Linux box with systemd, on 64-bit ARM, 32-bit ARM, x86_64 or RISC-V 64 |
The reporter ran the binary from /opt/outpace/outpace under their own systemd unit. Only the
end of the unit was visible in the post: two Environment= lines, ExecStart, a restart policy
and the [Install] section.
Environment="OUTPACE_PEER_LISTEN=0.0.0.0:8622"
Environment="OUTPACE_BIND=192.168.1.2:6878"
ExecStart=/opt/outpace/outpace serve
Restart=on-failure
RestartSec=5
[Install]
WantedBy=multi-user.targetTwo settings matter here. OUTPACE_BIND puts the HTTP API on the board's LAN address instead
of the default 127.0.0.1, which is what lets other devices play through it. OUTPACE_PEER_LISTEN
moves the peer port off the default 8621 to 8622; the post doesn't say why. The steps below
rebuild that setup on the packaged service, with a dedicated user and the hardening the repository's
unit already has.
- a board running DietPi, or any Debian-based system with systemd, with a fixed LAN address (set
a DHCP reservation on the router if you can). The examples use
192.168.1.2; - an architecture with a release build. Run
uname -mon the board:aarch64means the ARM64 package,armv7lthe ARMv7 one. See Installation; - a few hundred MiB of free RAM. On a 1 GB board, use the memory limits in Routers and Small Devices.
The .deb package installs the binary, an unprivileged outpace user and the systemd unit. For
an ARM64 board:
version=1.2.1
curl -LO "https://github.com/outpace-stream/outpace-engine/releases/download/v${version}/outpace_${version}_arm64.deb"
sudo apt install "./outpace_${version}_arm64.deb"
outpace --versionCheck the download against SHA256SUMS from the same release first; the steps are in
Installation. To run a bare binary under your
own unit, as the reporter did, use the unit in Deployment with
ExecStart pointing at your copy.
Edit /etc/outpace/outpace.env:
OUTPACE_BIND=192.168.1.2:6878
OUTPACE_PEER_LISTEN=0.0.0.0:8622Leave OUTPACE_PEER_LISTEN out to keep the default 8621. If you move it, any router port
forward must use the same number; see NAT and Port Mapping. On a small
board, add the low-memory settings from
Routers and Small Devices, starting with
OUTPACE_MAX_SESSIONS=1 and a smaller OUTPACE_SEED_STORE_BYTES.
sudo systemctl enable --now outpaceenable --now starts the service only if it isn't running yet. If Outpace was already running,
for example after an upgrade or an earlier setup, restart it so it reads the new settings:
sudo systemctl restart outpaceThen follow the log (Ctrl+C to stop) and look for listening on http://192.168.1.2:6878:
journalctl -u outpace -fFrom another machine on the LAN:
curl http://192.168.1.2:6878/streamsOpen a stream URL in any player or IPTV app on the LAN:
http://192.168.1.2:6878/streams/ace/0123456789abcdef0123456789abcdef01234567
Replace the placeholder with a real content id. The
Android app can use this board as its remote engine, and players that only speak
the AceStream API need OUTPACE_ACE_COMPAT=1; see
Playing Streams.
-
Only the LAN:
192.168.1.2:6878is reachable by anything on the network, and the API has no password. Never forward 6878 to the internet. - Peers: the peer port is the only one worth forwarding, and only if you want to upload as well as download. See Seeding and Peers.
- SD card wear: keep the default memory cache. A disk cache on an SD card or eMMC is rewritten constantly; use external storage if you need one.
- Other boards: the architecture table is in Routers and Small Devices.
This wiki is generated from docs/wiki/ in the main repository. To fix or improve a page, open a pull request there; the wiki is republished automatically when it merges, and edits made in the wiki web UI are overwritten.
Start
Watching
Publishing and peers
- Broadcasting
- Seeding and Peers
- Engine Camouflage
- NAT and Port Mapping
- Private Peer Mode
- Outbound Proxy
Running it
- Deployment
- Routers and Small Devices
- Migrating from AceStream Engine
- Support Sources and Operations
- Troubleshooting
- Releases and Versions
Success stories