Suggestion: Mention firewall and port requirements in the Linux installation guide

[Mithi83]

I've followed the guide on https://www.openhab.org/docs/installation/linux.html to install openHAB on a Fedora 37 VM. At the point where I wanted to access the fresh installation via HTTP I could not connect to the webservice and it took me a rather long time and a wireshark log to figure out what was wrong. In the end, my problem was the default firewall of the Fedora system that blocked port 8080 and 8443.

I can imagine that many Linux distributions come with some sort of restrictive default firewall config and mentioning the need to allow certain ports in the firewall could be necessary. While it is probably out of scope for the openHAB documentation to walk the user through their distributions firewall setup, it would have saved me some time if the need for a proper firewall configuration.

Therefore I suggest you add a section with a list of required ports and the hint to check if a firewall could get in the way. From what I've seen so far it seems to be 8080/tcp and 8443/tcp, but maybe that is incomplete. This could be part of a troubleshooting section or be an item in the "Recommended Additional Setup Steps" section.

For those interested what was necessary on Fedora (using firewalld):
sudo firewall-cmd --permanent --add-port=8080/tcp
sudo firewall-cmd --permanent --add-port=8443/tcp

[rkoshak]

Therefore I suggest you add a section with a list of required ports and the hint to check if a firewall could get in the way.

We would welcome it if you were to offer the change. You can do it all in the browser even. There's an "Edit this page in GitHub" link at the bottom of the page which will take you straight to the place to add your suggested changes.

https://community.openhab.org/t/wiki-how-to-contribute-to-the-openhab-documentation/111308 provides a great tutorial if you need it for how to do it but it's really simple.

Note: Port 5007 is used to host an LSP which VS Code can connect to to syntactically check your config as you type it. Some bindings may open additional ports.

[wborn]

This issue can be closed as it was fixed with #2007.