Verify all ports are free #983
Conversation
Found out I had some in use ports, this might be helpful to others starting out as well. Extracted the needed ports from docker-compose.yml using: ``` yq -r '.services[]?.ports[]? // empty' docker-compose.yml | \ grep ':' | \ sed -E 's/^"?([0-9]+):[0-9]+.*"?$/\1/' | \ sort -n | uniq ```
| The environment requires several ports to be free. | ||
| Use `ss` to check if any are in use—no output means they're available: | ||
|
|
||
| ``` | ||
| ss -tulnp|grep -E ':80|:3000|:4000|:5432|:5678|:8000|:8001|:8080' | ||
| ``` |
There was a problem hiding this comment.
What is ss? It doesn't seem to be a default tool on macos, ubuntu or alpine.
It is a good idea to inform people to check that the ports are free, but the actual numbers written out here are bound to go stale over time. What do you think about rephrasing this to something along the lines off "Make sure you aren't running any software on the ports required by docker-compose.yml" ?
There was a problem hiding this comment.
ss is one of the tools in https://en.wikipedia.org/wiki/Iproute2. I reasoned that's a pretty standard tool. I couldn't find something similar that's available on both macos and ubuntu. Anything older you'd prefer, like netstat or lsof maybe?
I thought about including the script mentioned in the commit message, but for an onboarding tutorial, a bit too verbose, although then always current.
I'll apply your rephrase if we can settle on a tool.
There was a problem hiding this comment.
Ah, didn't know netstat was considered legacy :) I typically use netstat on OSX, but fine to keep ss in this text, maybe with a link to that iproute2 page
There was a problem hiding this comment.
@Mark90 @kvdb-surf What should we do with this PR?
There was a problem hiding this comment.
Perhaps my 2 suggestions make it work for all
| Use `ss` to check if any are in use—no output means they're available: | ||
|
|
||
| ``` | ||
| ss -tulnp|grep -E ':80|:3000|:4000|:5432|:5678|:8000|:8001|:8080' |
There was a problem hiding this comment.
| ss -tulnp|grep -E ':80|:3000|:4000|:5432|:5678|:8000|:8001|:8080' | |
| netstat -tulnp | grep -E ':80|:3000|:4000|:5432|:5678|:8000|:8001|:8080' | |
| ss -tulnp|grep -E ':80|:3000|:4000|:5432|:5678|:8000|:8001|:8080' |
| ### Local environment | ||
|
|
||
| The environment requires several ports to be free. | ||
| Use `ss` to check if any are in use—no output means they're available: |
There was a problem hiding this comment.
| Use `ss` to check if any are in use—no output means they're available: | |
| Use either command below to check if any are in use. No output means they're available: |
Found out I had some in use ports, this might be helpful to others starting out as well.
Extracted the needed ports from docker-compose.yml using: