From d6ecb607d1d3a0fb4bf0748a8a61802d2f51a545 Mon Sep 17 00:00:00 2001
From: Andrew Nesbitt <andrewnez@gmail.com>
Date: Thu, 6 Aug 2026 22:20:41 +0100
Subject: [PATCH] Document upstream.debian in README and config.example.yaml

Follow-up to #229 which added the config key and env var but didn't
touch docs.
---
 README.md           | 7 +++++++
 config.example.yaml | 3 +++
 2 files changed, 10 insertions(+)

diff --git a/README.md b/README.md
index 4609b66..01012e2 100644
--- a/README.md
+++ b/README.md
@@ -376,6 +376,13 @@ Replace your existing sources.list entries, then:
 sudo apt update
 ```
 
+The upstream defaults to `http://deb.debian.org/debian`. To proxy a different APT repository (e.g. Ubuntu), set `upstream.debian` in the config file or `PROXY_UPSTREAM_DEBIAN` in the environment:
+
+```yaml
+upstream:
+  debian: "http://archive.ubuntu.com/ubuntu"
+```
+
 ### RPM / Yum / DNF
 
 Configure yum/dnf to use the proxy in `/etc/yum.repos.d/proxy.repo`:
diff --git a/config.example.yaml b/config.example.yaml
index 1176f5b..7cf7bb2 100644
--- a/config.example.yaml
+++ b/config.example.yaml
@@ -95,6 +95,9 @@ upstream:
   # Cargo crate download URL
   cargo_download: "https://static.crates.io/crates"
 
+  # Debian/APT repository URL (used by /debian endpoint)
+  debian: "http://deb.debian.org/debian"
+
   # Authentication for upstream registries
   # Keys are URL prefixes matched against request URLs.
   # Values can reference environment variables using ${VAR_NAME} syntax.