By popular demand from this post, here’s the write-up for my version of that travel server.
The travel server is shown with the, currently, bare 5V UPS board to its right. One day I hope to have a 3D printed case for both of those, but they’re currently separate as my 3D modeling skills are basically non-existent. The power cable is wrapped in aluminum foil and then wrapped in electrical tape due to EMI from the wifi adapter causing random glitches. A ferrite bead would probably solve that more elegantly, but I didn’t have any on hand so made due with what I have.
Hardware
- Banana Pi M4 Zero
- 1.5 GHz Quad Core ARM64
- 4 GB RAM
- 32 GB eMMC
- 1 TB Samsung PRO Plus SD Card (bought before prices went nuts)
- Li-2B UPS Board + 2x 3,000 mAh 18650 batteries
- USB-C to USB-A 90 degree angle adapter
- USB Nano Wifi adapter
Note: Unlike the Pi Zero, these have two USB ports. One is configured in host mode and the other in peripheral mode.
Features and Capabilities
- Multiple wifi clients can use this for network access
- Multiple “WAN” options
- Multiple VPN connections (OpenVPN, Wireguard, IPSEC) e.g.
- Privacy VPN for general internet traffic
- Wireguard to connect back to home network
- Ad-blocking via PiHole
- Local file sharing via Samba/SMB
- Locally-hosted web applications with valid hostnames and valid SSL certs (via Let’s Encrypt).
- SearxNG
- Jellyfin
- Pairdrop
- CodeServer
- Snapcast Server
- myMPD (MPD web UI)
- Kiwix (including full Wikipedia dump with images)
- NodeRED
- CalibreWeb
Travel Router / Access Point
For internet uplink, there are multiple options depending on need. By default, the internal/bulit-in wi-fi is the internet uplink and the USB wi-fi adapter is the client-facing AP interface. This is how I normally keep it configured in my use-cases.
Alternatively, the built-in wi-fi can be used as the client-facing AP and the uplink to the internet can be provided by a USB-tethered smartphone or a USB ethernet adapter --OR-- the internet uplink can be omitted entirely and either the USB or built-in wifi adapters can serve clients (or both: one in 2.4 GHz mode and the other in 5 GHz mode). Fortunately, the built-in wifi chip in the Banana Pi works well in AP mode but that’s not always the case (cough Orange Pi Zero W2 cough).
If a PC is connected to USB0 (the OTG port), the device will act as an ethernet gadget. The travel server will add its end of the usb0 interface into the LAN bridge along with the client-side AP. This means the connected PC will be on the same LAN as the wireless clients.
It’s also possible to add a USB ethernet adapter and bridge it into the LAN side as well.
Depending on configuration, a small USB-C hub may be needed. I’ve got one that includes a USB A port, ethernet port, and additional USB C port.
VPNs can also be configured as needed. I’ve got a privacy one that can route all traffic as well as a Wireguard one that connects back to my home LAN when I’m using it remotely.
DHCP and DNS are both provided by PiHole
Reverse Proxy
All applications hosted on the travel server are fronted by Nginx and use valid Let’s Encrypt certificates. This eliminates the need to install a custom CA cert in end devices or have the clients accept an untrusted self-signed cert.
This also ensures all applications are protected by TLS which is required for full functionality of some applications.
How does that work?
The hostname of the travel server (mobile) is a subdomain of my personal, project domain (mydomain.xyz). All applications are a subdomain of that (e.g. jellyfin.mobile.mydomain.xyz), and I simply request a wildcard cert from Let’s Encrypt for *.mobile.mydomain.xyz. Currently, Let’s Encrypt requires the use of DNS validation when requesting wildcard certificates.
Movies/TV
Movies and TV shows are provided by Jellyfin and are stored on the 1 TB SD card. I’ve tested 4 simultaneous streams, and the travel server didn’t even break a sweat. Granted, it’s not transcoding anything so I believe I’m mostly limited by USB, wifi, and/or SD card bandwidth in that regard.
For reliability, the Jellyfin database is stored on the internal 32 GB eMMC rather than the SD card. This both reduces wear and tear on the card as well as proves to be faster and more reliable.
CPU transoding is a non-starter, and the GPU drivers for these boards isn’t exactly well supported. The GPU drivers also rely on V4L which Jellyfin has deprecated for hardware transcoding, so I opted to forego transcoding entirely.
To load movies/TV shows on here, I pre-process them with ffmpeg in the following way:
- Scale to 720p to save space
- Encode to H.264 in an MP4 container (including subtitles as
mov_textif available) in yuv420p pixel format to avoid the need for remuxing or transcoding - Map only the primary English audio and subtitle streams to further save space
- Downmix multi-channel audio to two-channel stereo
Music
Music is provided by a combination of MPD and Snapcast and the library is also stored on the 1TB SD card.
MPD manages the music collection while Snapcast allows synchronized multi-room audio and connecting receivers via wifi.
For local playback, I use myMPD web UI and use its streaming feed or use the MPD and Snapcast clients on the end device. There’s also a Snapcast client installed on the travel server itself, so if you add a USB speaker it can playback music directly.
Books
It runs Calibre-Web to manage my book collection which is also stored on the 1 TB SD card. When my phone is connected to its wifi, it can use my FBReader app to connect to the Calibre library over OPDS to download books.
Development
The travel server runs CodeServer which is an un-Microsofted web-based version of VSCode. You can set that up however you want, but I’ve got it setup for:
- React / NextJS development
- Python development
- ESP8266/ESP32 development with Platform.io
Other services it runs to facilitate development include:
- NodeJS and Bun
- Postgres (via Docker)
- Mosquitto MQTT
- Redis
- CouchDB
- NodeRED
Offline Knowledge
Kiwix is installed with a large selection of ZIMS for offline reference.
- DevDocs for React, Bun, NodeJS, ExpressJS, NextJS, etc. Pretty much every major libarary and framework I work with has offline docs
- Full text Wikipedia dump with images (approx 130GB)
Search
I installed SearxNG so I always have an ad-free, AI-free, no BS search engine available.
File Sharing
The travel server has a few different ways to share files:
- Samba (SMB) shared folder
- PairDrop for quick and easy one-to-one local sharing in the browser or phone app
- SSHFS (alternative method of accessing the SMB shares
Future Plans / Not Yet Implemented
- Add data passthrough to the UPS board so a host PC can charge the UPS/power the travel server while also enumerating it as a USB ethernet device. Currently the UPS board only passes power and plugs into the peripheral USB port.
- Add some kind of tile server and map viewer. Inspired by this project.
- Set up captive portal so Android (and probably Apple, too) devices don’t freak out if there’s no internet uplink. Currently requires an annoying “Stay connected to this network” and enabling airplane mode so that DNS will work over the wifi connection if there’s no internet uplink available.
- Make a web UI to manage services/configs. Currently, config changes require SSH-ing in and modifying the config directly. I do have preset configs for different “modes” but you still have to swap them around by hand.
- Design and 3D print a case that can hold the UPS board and the travel server itself while allowing the travel server to be “ejected” (basically I imagine it slotting into it from the outside and connecting to fixed USB and mini HDMI connectors embedded in the case).
Cool! Please enlighten me of the use cases a bit. The offline part I get. But since you call it a travel server, I assume you also have a home server? Then why not just VPN home to access that? What benefits (other than being available offline) does the additional hardware being?
The original intent of this was a travel router that VPN’d back to home as well as providing PiHole ad blocking, but it ballooned when I just wanted to see how much could run on this little board. I didn’t have anything in mind when I made it other than if I could, so I had to invent reasons after the fact lol
SHTF Server
If shit ever hits the fan (evacuation order, natural disaster, house burns down, etc), this is something that’s easy to grab, takes up almost no space, can be powered for days with a power bank, and has all my important docs on an encrypted volume. If I’m stuck in a temporary shelter or whatever, I can keep myself entertained as well as a handful of other people who can connect to it.
I’ve also got cron jobs to sync important files from my main servers to this one, so it stays up to date.
Power Outages
We don’t maintain any permanent streaming subscriptions (only when there’s something good on like a new season of Star Trek drops lol). So if the power goes out, and I can’t run the main servers, this can (and has!) run from a power bank for about 36 hours. Everyone in the house can stream something different to their phone if they want.
Camping, Traveling, Etc.
Kinda covered under offline access, but can keep the kids entertained without cell service or racking up data overages.
I also made a couple of Snapcast receiver speakers with some old Pi Zero W’s so we can have wireless speakers around the campsite. I was able to add an RTL-SDR dongle to it and pipe the FM audio to Snapcast, so if there’s a game on, we can listen to that. I haven’t used that in practice, but it worked on the bench.
Internet access isn’t a given
I’ve had to travel places that have no or poor internet access and poor cell reception. Depends on where and why I have to travel and is always a crapshoot. This gives me a bare minimum environment that’s always on hand.
Black Start
If my homelab ever goes totally down or has a major malfunction, I’ve got copies of documentation, console passwords (that are normally kept in Vaultwarden hosted on the stack that’s unavailable in this scenario), and other resources to bring things back up. I host pretty much everything we use (including email) so when the lab is down (rare but does happen) it’s nice to have a backup stack.
Awesome!
This is sick! Thanks for this write-up.
One thing this shows off nicely is just how many services you can squeeze onto some pretty modest hardware. I know people with big server racks running mostly this same stuff.
Yeah, I was surprised as well by how many things can run concurrently and why this project ballooned like it did. It was originally just going to be a travel router and PiHole but I decided to see how much I could cram in there. There’s still room for more but I had to move on to other projects once winter was over. If/when I have time, I’d like to add a map tile server to the mix.
The only limit I’ve run into is when I’m running the NextJS dev server and Jellyfin at the same time. That’s just a bit too much demand on the memory so one or the other crashes. So I can’t watch JF while I work, but considering what’s hosting these, I can forgive it.
Great writeup and encouraging work! Thanks for taking the time to share and kudos for your work!
made due
made do?
Can I please stand behind you in the airport security queue, just to see what happens?
Ha, yeah, that UPS board isn’t going on any plane. I’d just use an approved power bank in that case.
Pretty much every major libarary and framework I work with has offline docs
Library, as in every library from npm that you import directly? Are Preact, lodash, MDN JS and Tailwind docs included in that collection? If I’m making a library, do I need to do anything specific to ease offline reading (and searching) of its website and readme along with other libraries if anybody finds it useful? All docs currently fit in these two pages.
- MDN (HTML, CSS, JS): Yes - Had to manually crawl/scrape that one myself. Took almost 3 days since I had a pretty generous delay between pages.
- Tailwind: Yes (v3 anyway)
The Kiwix web interface has a search, and it’s decent. AFAIK, unless you build your own somehow, that’s all there is for that.
Thanks for checking! Meanwhile I found the instructions on adding more scrapers for making documentation of other libraries and tools available offline if one wants to write them. Idk if it makes the docs available in Kiwix automatically, but Kiwix community seems to base its offline documentation packages on indexing this project.
Nice. I forget what project I used (it’s been over a year and I haven’t used it since). I just remember it was Docker based and I setup a wrapper script where I could just feed it a base URL to start from and a filename for its output. It definitely didn’t do the cleanup and polishing that DevDocs does with theirs, but it worked well enough for my purposes.
Very very nice. Some good inspiration in this post, especially the mobile Jellyfin part.
This is insane.
Insanely cool!
Very very cool! Would love to see it all in the case once you design and print it.
