homelabprivacyai

Turn a $15 Android TV Box into an Armbian Linux Server

🤖 Researched and drafted automatically from the official docs, and reviewed before publishing. Commands are taken from the source projects — but always sanity-check before running anything on your own hardware.

Your junk drawer probably has an old Android TV box gathering dust. If it’s built on an Amlogic S905, S922, or related SoC, ophub’s amlogic-s9xxx-armbian project turns it into a real Linux server that can run Docker, Pi-hole, and whatever else you need. The catch: check the supported device list first, and always boot from USB or SD card before touching eMMC.

Check Your Box Against the Support List

Before you do anything, verify your exact model against the official supported devices list. The repository supports specific SoCs: S905, S905W, S905L, S905L2, S905L3, S905D, S905X, S905X2, S905X3, S905X4, S912, and S922X are the main Amlogic targets. Look for your box’s model name in that table. If it’s not there, stop—flashing the wrong image can brick the device.

Prepare Your Boot Media

  1. Download the Armbian image for your specific device from the Releases page. The filename includes the board codename (e.g., Armbian_*_s905x3_*.img.xz).
  2. Decompress the .xz file if needed.
  3. Use Rufus (Windows) or balenaEtcher (Linux/Mac) to write the image to a USB drive or microSD card. Do not use dd unless you know what you’re doing—one typo wipes your workstation.
  4. Insert the USB drive or SD card into the TV box.

Boot Armbian for the First Time

  1. Power on the TV box with the USB drive or SD card inserted. It should boot into Armbian instead of Android. This may take 30–60 seconds.
  2. Log in via SSH or serial console (if you have a USB-to-serial adapter):
    • Default username: root
    • Default password: 1234
    • SSH port: 22
    • IP address: Check your router’s DHCP client list, or use arp-scan to find it.
  3. Change the root password immediately:
passwd

Running from USB or SD is safe for testing. To make Armbian permanent and faster, install it to the device’s internal eMMC storage:

armbian-install

This command presents a menu. Accept the defaults unless you have a specific reason not to. The tool will partition and format the eMMC, then copy the system. Once complete, power off, remove the USB drive or SD card, and reboot.

Warning: If something goes wrong during eMMC installation, the device may not boot. Keep your USB/SD card handy as a recovery boot source. If the box fails to boot after eMMC install, insert the USB/SD card again and use armbian-ddbr to restore the original Android system from a backup (if you made one).

Back Up the Original Android System First

Before you install to eMMC, preserve your original Android system so you can restore it later if needed:

armbian-ddbr

At the prompt, enter b to back up. This creates a backup file of the original eMMC partition table and system. Store this file safely on an external drive or cloud storage.

Configure and Update the System

Once Armbian is running, configure it:

  1. Update the package list and kernel:
armbian-update

This updates to the latest stable kernel for your device. You can specify a kernel version with -k (e.g., armbian-update -k 6.6.12) or let it auto-select the latest in the series.

  1. Choose a faster package mirror for your region:
armbian-apt

Select a mirror close to you to speed up package downloads.

  1. Install common software (Docker, Pi-hole, etc.):
armbian-software

This opens a menu of pre-packaged applications. You can install Docker, Pi-hole, Nextcloud, and other services with one command.

  1. Adjust system settings:
armbian-config

Use this to enable overlays, configure network settings, or tweak performance.

Create Swap Space If Needed

If you’re running memory-intensive workloads (like multiple Docker containers), create a swap partition:

armbian-swap 1

This allocates 1 GB of disk space as virtual memory. Increase the number if you need more.

Keep Admin Interfaces Off the Internet

If you expose this box to the internet (e.g., as a VPN endpoint or reverse proxy), secure it properly:

  • Never expose SSH, the Armbian web UI, or any admin panel directly to the public internet.
  • Run a VPN server on it if you need remote access, and access the admin interface only through the VPN tunnel.
  • Use a firewall (e.g., ufw) to restrict inbound traffic to only what you need.
  • Change the default password on day one.

Restore the Original Android System

If you need to go back to Android:

armbian-ddbr

Enter r at the prompt to restore from your backup. This only works if you made a backup before installing Armbian.

Is It Worth It?

Yes, if you have a supported box lying around and want a low-power Linux server. A $15 S905X3 box consumes 5–10 watts and can comfortably run Docker, Pi-hole, or a lightweight home automation hub. The trade-off: these boxes are not high-performance (usually 2–4 CPU cores, 2–4 GB RAM), so don’t expect to run a Kubernetes cluster or transcoding workloads. For a DNS sinkhole, media server, or small Docker lab, it’s hard to beat the price-to-power ratio. Always boot from USB first and keep that backup handy—it’s your insurance policy against a brick.

Related video

New self-hosted AI & homelab shorts, daily.

Subscribe on YouTube

Related guides

← All guides