Add docs about using caching proxies with our package repos. (#7909)
This adds some basic documentation about how to use our package repositories through caching proxies, since PackageCloud's configuration doesn't really do anything to properly support it. Relevant to: #7905
Austin S. Hemmelgarn committed
Jan 30, 2020 at 07:45 UTC
7e6a6bef0798248ce2cde4a166e7bc3d1f4791c5
1 file changed
+19
packaging/installer/methods/packages.md
+19
@@ -24,6 +24,25 @@ We provide two separate repositories, one for our stable releases and one for ou
24
25
Visit the repository pages and follow the quick set-up instructions to get started.
26
27
+## Using caching proxies with PackageCloud repositories
28
+
29
+PackageCloud only provides HTTPS access to repositories they host, which
30
+means in turn that Netdata's package repositories are only accessible
31
+via HTTPS. This is known to cause issues with some setups that use a
32
+caching proxy for package downloads.
33
+
34
+If you are using such a setup, there are a couple of ways you can work around this:
35
+
36
+* Configure your proxy to automatically pass through HTTPS connections
37
+ without caching them. This is the simplest solution, but means that
38
+ downloads of Netdata pacakges will not be cached.
39
+* Mirror the respository locally on your proxy system, and use that mirror
40
+ when installing on other systems. This requires more setup and more disk
41
+ space on the caching host, but it lets you cache the packages locally.
42
+* Some specific caching proxies may have alternative configuration
43
+ options to deal with these issues. You can find such options in their
44
+ documentation.
45
+
46
## What's next?
47
48
When you finish installing Netdata, be sure to visit our [step-by-step tutorial](../../../docs/step-by-step/step-00.md)