From 0e792be751b01d1b372cb93c211e494c56c9c60e Mon Sep 17 00:00:00 2001
From: Justin Oros <JustinOros@gmail.com>
Date: Thu, 16 Apr 2026 14:46:25 -0700
Subject: [PATCH] add troubleshooting section for beta.armbian.com apt repo
 issue

---
 README.md | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/README.md b/README.md
index f0f1ede..1b3d9de 100644
--- a/README.md
+++ b/README.md
@@ -172,6 +172,20 @@ Before committing, ensure the following do not contain real credentials:
 
 ---
 
+## Troubleshooting
+
+### `apt update` fails with beta.armbian.com error
+
+On some Armbian images, a beta apt repository is enabled by default and may cause `apt update` to fail. Comment it out:
+
+```bash
+grep -r "beta.armbian" /etc/apt/sources.list /etc/apt/sources.list.d/
+```
+
+Open the file that contains it (usually `/etc/apt/sources.list.d/armbian.sources`) and comment out or remove the line referencing `beta.armbian.com`, then run `apt update` again.
+
+---
+
 ## Requirements
 
 **Spoke:** Armbian (Debian-based), ARM device, Docker, autossh, git