Skip to content

Commit 80a225c

Browse files
authored
docs(deployment): add note about potential firewall issues on RHEL (#2707)
Add a warning box to the troubleshooting advice (https://docs.browsertrix.com/deploy/local/#debugging-pod-issues) in the local deployment guide about firewall rules and disabling firewalld on RHEL. See https://forum.webrecorder.net/t/browsertrix-deployment-stalls-when-initializing-container-migrations/916/5 for context.
1 parent 7a6b1d7 commit 80a225c

File tree

1 file changed

+8
-3
lines changed

1 file changed

+8
-3
lines changed

frontend/docs/docs/deploy/local.md

Lines changed: 8 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -180,11 +180,16 @@ There should be 4 pods listed: backend, frontend, minio, and mongodb. If any one
180180

181181
To get more details about why a pod has not started, run `#!sh kubectl describe <podname>` and see the latest status at the bottom.
182182

183-
Often, the error may be obvious, such as failed to pull an image.
183+
Often, the error may be obvious, such as "failed to pull an image."
184184

185-
If the pod is running, or previously ran, you can also get the logs from the container by running `#!sh kubectl logs <podname>`
185+
If the pod is running, or previously ran, you can also get the logs from the container by running `#!sh kubectl logs <podname>`.
186186

187-
The outputs of these commands are helpful when reporting an issue [on GitHub](https://github.com/webrecorder/browsertrix/issues)
187+
The outputs of these commands are helpful when reporting an issue [on GitHub](https://github.com/webrecorder/browsertrix/issues).
188+
189+
??? info "Firewall rules (on RHEL/Fedora)"
190+
191+
On Red Hat Enterprise Linux and derivatives, communication between pods might be blocked by firewalld.
192+
There are short guides on configuring the firewall for these systems in the [k3s](https://docs.k3s.io/installation/requirements?&os=rhel#operating-systems) and [Microk8s](https://microk8s.io/docs/troubleshooting#:~:text=Pod%20communication%20problems%20when%20using%20firewall-cmd) documentation.
188193

189194
## Updating the Cluster
190195

0 commit comments

Comments
 (0)