Skip to content

fix: support macOS installation and add swarm init guidance #140

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
cheonkyu wants to merge 2 commits into
base: main
Choose a base branch
from
Open

fix: support macOS installation and add swarm init guidance #140

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
d98717a
fix: support macOS installation and add swarm init guidance
cheonkyu Feb 23, 2026
5d55f60
Update apps/website/public/install.sh
cheonkyu Feb 24, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
61 changes: 36 additions & 25 deletions apps/website/public/install.sh
100644 → 100755
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,13 @@
# Usage with bash: DOKPLOY_VERSION=canary bash install.sh
# Usage with bash: DOKPLOY_VERSION=latest bash install.sh
# Usage with bash: bash install.sh (detects latest stable version)

# Detect OS
IS_MAC=false
if [ "$(uname)" = "Darwin" ]; then
IS_MAC=true
fi

detect_version() {
local version="${DOKPLOY_VERSION}"

Expand Down Expand Up @@ -78,6 +85,15 @@ generate_random_password() {
echo "$password"
}

check_port() {
local port=$1
if [ "$IS_MAC" = true ]; then
lsof -Pi :$port -sTCP:LISTEN >/dev/null 2>&1
else
ss -tulnp | grep ":$port " >/dev/null 2>&1
fi
}

install_dokploy() {
# Detect version tag
VERSION_TAG=$(detect_version)
Expand All @@ -89,36 +105,19 @@ install_dokploy() {
exit 1
fi

# check if is Mac OS
if [ "$(uname)" = "Darwin" ]; then
echo "This script must be run on Linux" >&2
exit 1
fi

# check if is running inside a container
if [ -f /.dockerenv ]; then
echo "This script must be run on Linux" >&2
Copy link

@greptile-apps greptile-apps bot Feb 23, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

error message says "must be run on Linux" but script now supports macOS - update message to say "cannot be run inside a container" or similar

exit 1
fi

# check if something is running on port 80
if ss -tulnp | grep ':80 ' >/dev/null; then
echo "Error: something is already running on port 80" >&2
exit 1
fi

# check if something is running on port 443
if ss -tulnp | grep ':443 ' >/dev/null; then
echo "Error: something is already running on port 443" >&2
exit 1
fi

# check if something is running on port 3000
if ss -tulnp | grep ':3000 ' >/dev/null; then
echo "Error: something is already running on port 3000" >&2
echo "Dokploy requires port 3000 to be available. Please stop any service using this port." >&2
exit 1
fi
# Port availability checks
for port in 80 443 3000; do
if check_port $port; then
echo "Error: something is already running on port $port" >&2
exit 1
fi
done

command_exists() {
command -v "$@" > /dev/null 2>&1
Expand Down Expand Up @@ -189,7 +188,12 @@ install_dokploy() {
}

get_private_ip() {
ip addr show | grep -E "inet (192\.168\.|10\.|172\.1[6-9]\.|172\.2[0-9]\.|172\.3[0-1]\.)" | head -n1 | awk '{print $2}' | cut -d/ -f1
if [ "$IS_MAC" = true ]; then
# macOS: Use osascript for reliable local IP
ipconfig getifaddr en0 2>/dev/null || ipconfig getifaddr en1 2>/dev/null || echo "127.0.0.1"
else
ip addr show | grep -E "inet (192\.168\.|10\.|172\.1[6-9]\.|172\.2[0-9]\.|172\.3[0-1]\.)" | head -n1 | awk '{print $2}' | cut -d/ -f1
fi
}

advertise_addr="${ADVERTISE_ADDR:-$(get_private_ip)}"
Expand All @@ -216,6 +220,13 @@ install_dokploy() {

if [ $? -ne 0 ]; then
echo "Error: Failed to initialize Docker Swarm" >&2
if [ "$IS_MAC" = true ]; then
echo "" >&2
echo "💡 Tip for macOS users:" >&2
echo "Docker Desktop for Mac sometimes fails to recognize the host IP." >&2
echo "Please try running the script with a manual IP like this:" >&2
echo "sudo ADVERTISE_ADDR=127.0.0.1 bash install.sh" >&2
fi
exit 1
fi

Expand Down