From f51ea346313cce991f3d02572c51ce032ca725a9 Mon Sep 17 00:00:00 2001 From: Michael Foley Date: Mon, 23 Mar 2020 09:20:55 -0400 Subject: [PATCH] Resolves #2370 - legacy iptables for Raspbian Buster k3s networking requires legacy iptables. Update documentation with instructions to configure this for Raspbian Buster --- content/k3s/latest/en/advanced/_index.md | 11 +++++++++++ .../installation/installation-requirements/_index.md | 6 ++++-- 2 files changed, 15 insertions(+), 2 deletions(-) diff --git a/content/k3s/latest/en/advanced/_index.md b/content/k3s/latest/en/advanced/_index.md index a7b3a4262e0..20a0367ec8e 100644 --- a/content/k3s/latest/en/advanced/_index.md +++ b/content/k3s/latest/en/advanced/_index.md @@ -15,6 +15,7 @@ This section contains advanced information describing the different ways you can - [Starting the server with the installation script](#starting-the-server-with-the-installation-script) - [Additional preparation for Alpine Linux setup](#additional-preparation-for-alpine-linux-setup) - [Running K3d (K3s in Docker) and docker-compose](#running-k3d-k3s-in-docker-and-docker-compose) +- [Raspbian Buster - Enable legacy iptables](#raspbian-buster---enable-legacy-iptables) # Auto-Deploying Manifests @@ -162,3 +163,13 @@ Alternatively the `docker run` command can also be used: -e K3S_TOKEN=${NODE_TOKEN} \ --privileged rancher/k3s:vX.Y.Z + +# Raspbian Buster - enable legacy iptables + +Raspbian Buster defaults to using `nftables` instead of `iptables`. **K3S** networking features require `iptables` and do not work with `nftables`. Follow the steps below to switch configure **Buster** to use `legacy iptables`: +``` +sudo iptables -F +sudo update-alternatives --set iptables /usr/sbin/iptables-legacy +sudo update-alternatives --set ip6tables /usr/sbin/ip6tables-legacy +sudo reboot +``` \ No newline at end of file diff --git a/content/k3s/latest/en/installation/installation-requirements/_index.md b/content/k3s/latest/en/installation/installation-requirements/_index.md index e2335f785a6..58ddcb2cd11 100644 --- a/content/k3s/latest/en/installation/installation-requirements/_index.md +++ b/content/k3s/latest/en/installation/installation-requirements/_index.md @@ -17,9 +17,11 @@ K3s should run on just about any flavor of Linux. However, K3s is tested on the * Ubuntu 16.04 (amd64) * Ubuntu 18.04 (amd64) -* Raspbian Buster (armhf) +* Raspbian Buster (armhf) **NOTE: requires legacy iptables. See Note below. + +> * If you are using **Raspbian Buster**, follow [these steps]({{}}/k3s/latest/en/advanced/#raspbian-buster---enable-legacy-iptables) to switch to legacy iptables. +> * If you are using **Alpine Linux**, follow [these steps]({{}}/k3s/latest/en/advanced/#additional-preparation-for-alpine-linux-setup) for additional setup. -> If you are using Alpine Linux, follow [these steps]({{}}/k3s/latest/en/advanced/#additional-preparation-for-alpine-linux-setup) for additional setup. ## Hardware