docs: task class: improve_docs — add a troubleshooting note to packages.md (#22480)
docs: update docs/netdata-debian-trixie-repo-404-missing-repoconfig Co-authored-by: nedi-app[bot] <nedi-app[bot]@users.noreply.github.com>
nedi-app[bot] committed
May 18, 2026 at 13:19 UTC
d847a95684a7ed530bfdcc33eb8e57500fddacef
1 file changed
+44
packaging/installer/methods/packages.md
+44
@@ -182,6 +182,50 @@ Enabled: Yes
182
sudo apt install netdata
183
```
184
185
+### Manual Repository Configuration (Without Config Package)
186
+
187
+<details>
188
+<summary>If the repoconfig package is not yet available for your distribution</summary>
189
+<br/>
190
+
191
+If the repository configuration package for your distribution is not available at the [repoconfig index](https://repository.netdata.cloud/repos/repoconfig/index.html) (for example, when a new Debian or Ubuntu release is not yet covered), you can configure the APT repository manually.
192
+
193
+:::tip
194
+
195
+Using [kickstart.sh](/packaging/installer/methods/kickstart.md) is the recommended way to install Netdata. It handles repository setup automatically with fallback logic when a config package is not available.
196
+
197
+:::
198
+
199
+1. Download and dearmor the GPG key:
200
+
201
+ ```bash
202
+ sudo curl -fL https://repository.netdata.cloud/netdatabot.gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/netdata-archive-keyring.gpg
203
+ ```
204
+
205
+2. Create the repository configuration using Deb822 format:
206
+
207
+ ```bash
208
+ sudo tee /etc/apt/sources.list.d/netdata.sources <<EOF
209
+ Types: deb
210
+ URIs: http://repository.netdata.cloud/repos/stable/debian/
211
+ Suites: YOUR_CODENAME/
212
+ Signed-By: /usr/share/keyrings/netdata-archive-keyring.gpg
213
+ By-Hash: Yes
214
+ Enabled: Yes
215
+ EOF
216
+ ```
217
+
218
+ Replace `YOUR_CODENAME` with your distribution codename (for example, `trixie`). Keep the trailing slash after the codename. For Ubuntu-based systems, change `debian/` to `ubuntu/` in the `URIs` line.
219
+
220
+3. Update package lists and install Netdata:
221
+
222
+ ```bash
223
+ sudo apt update
224
+ sudo apt install netdata
225
+ ```
226
+
227
+</details>
228
+
229
## Example: Complete Installation on Ubuntu 22.04 (Jammy)
230
231
<details>