Skip to content

armgit / Ix

Public Imported from GitHub
0

Understand any codebase instantly. System intelligence for codebases, built for humans and AI.

feat: auto-install all deps in install script (#146)

Riley Thompson5728519cc0ea
diff --git a/requirements.txt b/requirements.txt
new file mode 100644
index 00000000..5e5d8513
--- /dev/null
+++ b/requirements.txt
@@ -0,0 +1,116 @@
+# Ix — System Requirements
+#
+# Everything listed here is checked and installed by the install script:
+# curl -fsSL https://ix-infra.com/install.sh | sh
+#
+# Fully automated on macOS and Linux.
+# Windows requires manual Docker Desktop install, then re-run.
+#
+# ============================================================================
+# STEP 0: System prerequisites (auto-installed if missing)
+# ============================================================================
+
+# curl or wget — needed to run the install script itself
+# If you ran the curl | sh command, you already have curl.
+# The script also supports wget as a fallback.
+curl # or wget
+
+# Homebrew — macOS package manager (auto-installed on macOS if missing)
+# https://brew.sh — used to install Node, Docker, git
+# Not needed on Linux (uses native package managers).
+homebrew # macOS only
+
+# git — required by ix CLI for workspace detection
+# macOS: Xcode Command Line Tools or brew install git
+# Linux: apt/dnf/yum/apk install git
+git>=2
+
+# ============================================================================
+# STEP 1: Node.js (auto-installed/upgraded if missing or too old)
+# ============================================================================
+
+# Node.js >= 18 (installer targets Node 22 LTS)
+# macOS: brew install node OR official .pkg installer
+# Linux: NodeSource apt/dnf/yum repo (setup_22.x) OR apk
+# Windows: manual from https://nodejs.org/
+node>=18
+npm>=8 # bundled with Node.js
+
+# ============================================================================
+# STEP 2: Docker + Docker Compose (auto-installed if missing)
+# ============================================================================
+
+# Docker Engine / Docker Desktop (auto-installed)
+# macOS: brew install --cask docker OR direct .dmg download
+# Linux: https://get.docker.com convenience script
+# User added to docker group. systemd service started + enabled.
+# Windows: NOT auto-installed — manual Docker Desktop required.
+#
+# FIRST LAUNCH (macOS): Docker Desktop shows a license agreement + optional
+# sign-in. The script detects this, shows instructions, and waits up to
+# 5 minutes. No re-run needed.
+#
+# RATE LIMITS: Docker Hub limits unauthenticated pulls to 100/6hrs per IP.
+# If the pull fails, the script tells the user to run "docker login" (free).
+# The Ix Memory Layer image is on GHCR (no rate limits for public images).
+docker>=20
+
+# Docker Compose v2 (ships as Docker CLI plugin)
+# Bundled with Docker Desktop and modern Docker Engine.
+# If missing on Linux, the script installs the plugin from GitHub.
+docker-compose>=2.0
+
+# ============================================================================
+# STEP 3: Backend services (managed by Docker, no manual install)
+# ============================================================================
+
+# ArangoDB 3.12 — graph database (Docker container on 127.0.0.1:8529)
+arangodb==3.12
+
+# Ix Memory Layer — Scala/JVM HTTP API (Docker container on 127.0.0.1:8090)
+ix-memory-layer==latest
+
+# ============================================================================
+# STEP 4: ix CLI (downloaded as pre-built binary)
+# ============================================================================
+
+# Pre-built tarball from GitHub Releases, extracted to ~/.ix/cli/
+# Wrapper script placed in /usr/local/bin/ix or ~/.local/bin/ix
+# Platforms: linux-amd64, linux-arm64, darwin-amd64, darwin-arm64, windows-amd64
+
+# ============================================================================
+# ALSO INSTALLED (used by ix commands)
+# ============================================================================
+
+# ripgrep — used by "ix text" for fast codebase text search
+# macOS: brew install ripgrep
+# Linux: apt/dnf/apk install ripgrep
+# Falls back to a warning if install fails (non-fatal)
+ripgrep>=13
+
+# ============================================================================
+# NETWORK ENDPOINTS ACCESSED
+# ============================================================================
+
+# https://api.github.com — resolve latest release version
+# https://github.com — download CLI tarball
+# https://raw.githubusercontent.com — download docker-compose.yml
+# https://ghcr.io — pull Ix Memory Layer image
+# https://nodejs.org — Node.js installer (macOS no-brew)
+# https://deb.nodesource.com — NodeSource apt (Linux)
+# https://rpm.nodesource.com — NodeSource rpm (Linux)
+# https://get.docker.com — Docker install script (Linux)
+# https://desktop.docker.com — Docker Desktop .dmg (macOS no-brew)
+# https://brew.sh — Homebrew installer (macOS)
+
+# ============================================================================
+# DIRECTORIES CREATED
+# ============================================================================
+
+# ~/.ix/ Ix home directory
+# ~/.ix/config.yaml CLI configuration
+# ~/.ix/backend/ Docker Compose file for local backend
+# ~/.ix/cli/ Installed CLI binary + node_modules
+#
+# Wrapper: /usr/local/bin/ix (if writable) or ~/.local/bin/ix (fallback)
+# Ports: 8090 (Memory Layer), 8529 (ArangoDB) — localhost only
diff --git a/scripts/install/install.sh b/scripts/install/install.sh
index 68808383..1d90f2e1 100755
--- a/scripts/install/install.sh
+++ b/scripts/install/install.sh
@@ -59,10 +59,10 @@ step() { printf "\n-- %s --\n" "$*"; }
if command -v curl >/dev/null 2>&1; then
_fetch() { curl -fsSL "$1"; }
- _download() { curl -fsSL "$1" -o "$2"; }
+ _download() { curl -fL --progress-bar "$1" -o "$2"; }
elif command -v wget >/dev/null 2>&1; then
_fetch() { wget -qO- "$1"; }
- _download() { wget -qO "$2" "$1"; }
+ _download() { wget --show-progress -qO "$2" "$1" 2>&1 || wget -O "$2" "$1"; }
else
err "curl or wget is required but neither was found.
Install one first and re-run:
@@ -139,7 +139,14 @@ detect_platform() {
arch="$(uname -m)"
case "$os" in
- darwin) os="darwin" ;;
+ darwin)
+ os="darwin"
+ # uname lies under Rosetta — detect real hardware
+ real_arm="$(sysctl -n hw.optional.arm64 2>/dev/null || echo 0)"
+ if [ "$real_arm" = "1" ]; then
+ arch="arm64"
+ fi
+ ;;
linux) os="linux" ;;
mingw*|msys*|cygwin*) os="windows" ;;
*) err "Unsupported OS: $os" ;;
@@ -169,6 +176,104 @@ PLATFORM=$(detect_platform)
echo " Version: $VERSION"
echo " Platform: $PLATFORM"
+# -- Step 0: System prerequisites --
+
+step "0. System prerequisites (git, Homebrew)"
+
+# Homebrew — macOS package manager (used to install Node, Docker, git)
+case "$(uname -s)" in
+ Darwin)
+ if ! command -v brew >/dev/null 2>&1; then
+ echo " Installing Homebrew (macOS package manager)..."
+ /bin/bash -c "$(_fetch https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" < /dev/null
+ # Add brew to PATH for this session (Apple Silicon vs Intel)
+ if [ -x "/opt/homebrew/bin/brew" ]; then
+ eval "$(/opt/homebrew/bin/brew shellenv)"
+ elif [ -x "/usr/local/bin/brew" ]; then
+ eval "$(/usr/local/bin/brew shellenv)"
+ fi
+ if command -v brew >/dev/null 2>&1; then
+ info "Homebrew installed"
+ else
+ warn "Homebrew installed but not in PATH yet — open a new terminal after install"
+ fi
+ else
+ info "Homebrew is available"
+ fi
+ ;;
+esac
+
+# git — required by ix CLI
+if ! command -v git >/dev/null 2>&1; then
+ echo " Installing git..."
+ case "$(uname -s)" in
+ Darwin)
+ if command -v xcode-select >/dev/null 2>&1; then
+ echo " Installing Xcode Command Line Tools (includes git)..."
+ echo " A dialog may appear — click Install and wait."
+ xcode-select --install 2>/dev/null || true
+ printf " Waiting for git..."
+ i=0
+ while [ "$i" -lt 120 ]; do
+ if command -v git >/dev/null 2>&1; then break; fi
+ printf "."
+ sleep 2
+ i=$((i + 1))
+ done
+ echo ""
+ fi
+ if ! command -v git >/dev/null 2>&1 && command -v brew >/dev/null 2>&1; then
+ brew install git < /dev/null
+ fi
+ ;;
+ Linux)
+ if command -v apt-get >/dev/null 2>&1; then
+ sudo apt-get update -qq < /dev/null && sudo apt-get install -y git < /dev/null
+ elif command -v dnf >/dev/null 2>&1; then
+ sudo dnf install -y git < /dev/null
+ elif command -v yum >/dev/null 2>&1; then
+ sudo yum install -y git < /dev/null
+ elif command -v apk >/dev/null 2>&1; then
+ sudo apk add git < /dev/null
+ fi
+ ;;
+ esac
+ if ! command -v git >/dev/null 2>&1; then
+ err "git is required. Install it manually: https://git-scm.com/downloads"
+ fi
+ info "git installed"
+else
+ info "git is available"
+fi
+
+# ripgrep — used by "ix text" for fast codebase search
+if ! command -v rg >/dev/null 2>&1; then
+ echo " Installing ripgrep..."
+ case "$(uname -s)" in
+ Darwin)
+ if command -v brew >/dev/null 2>&1; then
+ brew install ripgrep < /dev/null 2>/dev/null
+ fi
+ ;;
+ Linux)
+ if command -v apt-get >/dev/null 2>&1; then
+ sudo apt-get install -y ripgrep < /dev/null 2>/dev/null
+ elif command -v dnf >/dev/null 2>&1; then
+ sudo dnf install -y ripgrep < /dev/null 2>/dev/null
+ elif command -v apk >/dev/null 2>&1; then
+ sudo apk add ripgrep < /dev/null 2>/dev/null
+ fi
+ ;;
+ esac
+ if command -v rg >/dev/null 2>&1; then
+ info "ripgrep installed"
+ else
+ warn "ripgrep not installed — 'ix text' will not be available"
+ fi
+else
+ info "ripgrep is available"
+fi
+
# -- Step 1: Check / Install Node.js --
step "1. Node.js (runtime)"
@@ -289,72 +394,280 @@ else
info "Node.js $(node -v) installed"
fi
-# -- Step 2: Check / Install Docker --
+# -- Step 2: Check / Install Docker + Docker Compose --
+
+step "2. Docker + Docker Compose"
+
+install_docker() {
+ case "$(uname -s)" in
+ Darwin)
+ # Kill any lingering Docker processes from a previous install/run
+ osascript -e 'quit app "Docker"' 2>/dev/null || true
+ pkill -f "Docker Desktop" 2>/dev/null || true
+ pkill -f "com.docker" 2>/dev/null || true
+ sleep 1
+
+ # Detect real hardware — uname lies under Rosetta (reports x86_64 on ARM)
+ real_arch="$(sysctl -n hw.optional.arm64 2>/dev/null || echo 0)"
+ if [ "$real_arch" = "1" ]; then
+ arch_suffix="arm64"
+ else
+ arch_suffix="amd64"
+ fi
+
+ echo " Installing Docker Desktop for macOS ($arch_suffix)..."
+ echo " (this downloads ~700MB — may take a few minutes)"
+ echo ""
+
+ # Remove any existing Docker binaries from previous installs
+ for f in /usr/local/bin/docker /usr/local/bin/docker-compose \
+ /usr/local/bin/docker-credential-desktop \
+ /usr/local/bin/docker-credential-ecr-login \
+ /usr/local/bin/docker-credential-osxkeychain \
+ /usr/local/bin/com.docker.cli \
+ /usr/local/bin/kubectl.docker /usr/local/bin/hub-tool \
+ /usr/local/bin/docker-index /usr/local/bin/hyperkit; do
+ if [ -e "$f" ] || [ -L "$f" ]; then
+ rm -f "$f" 2>/dev/null || sudo rm -f "$f" 2>/dev/null || true
+ fi
+ done
+ brew uninstall --cask docker 2>/dev/null || true
+
+ dmg=$(mktemp /tmp/docker-XXXXXX.dmg)
+ echo " Downloading Docker Desktop..."
+ _download "https://desktop.docker.com/mac/main/${arch_suffix}/Docker.dmg" "$dmg"
+ echo " Mounting installer..."
+ hdiutil attach "$dmg" -quiet -nobrowse -mountpoint /Volumes/Docker < /dev/null
+ echo " Copying to /Applications (may require your password)..."
+ sudo rm -rf /Applications/Docker.app 2>/dev/null || true
+ sudo cp -R /Volumes/Docker/Docker.app /Applications/ < /dev/null &
+ CP_PID=$!
+ while kill -0 "$CP_PID" 2>/dev/null; do
+ printf "."
+ sleep 1
+ done
+ wait "$CP_PID" || true
+ echo " done"
+ hdiutil detach /Volumes/Docker -quiet
+ rm -f "$dmg"
+ info "Docker Desktop installed"
+ ;;
+ Linux)
+ echo " Installing Docker Engine via get.docker.com..."
+ _fetch https://get.docker.com | sh < /dev/null
+ if ! id -nG "$USER" 2>/dev/null | grep -qw docker; then
+ echo " Adding $USER to the docker group..."
+ sudo usermod -aG docker "$USER" < /dev/null 2>/dev/null || true
+ fi
+ if command -v systemctl >/dev/null 2>&1; then
+ sudo systemctl start docker < /dev/null 2>/dev/null || true
+ sudo systemctl enable docker < /dev/null 2>/dev/null || true
+ fi
+ if ! docker compose version >/dev/null 2>&1; then
+ echo " Installing Docker Compose plugin..."
+ compose_arch="x86_64"
+ if [ "$(uname -m)" = "aarch64" ]; then compose_arch="aarch64"; fi
+ compose_url="https://github.com/docker/compose/releases/latest/download/docker-compose-linux-${compose_arch}"
+ sudo mkdir -p /usr/local/lib/docker/cli-plugins
+ sudo _download "$compose_url" /usr/local/lib/docker/cli-plugins/docker-compose
+ sudo chmod +x /usr/local/lib/docker/cli-plugins/docker-compose
+ fi
+ ;;
+ MINGW*|MSYS*|CYGWIN*)
+ echo ""
+ echo " Docker Desktop is required on Windows."
+ echo " Download and install from:"
+ echo " https://docs.docker.com/desktop/install/windows-install/"
+ echo ""
+ echo " After installing, restart your terminal and re-run this installer."
+ echo ""
+ echo " To install the CLI only (no backend):"
+ echo " IX_SKIP_BACKEND=1 sh install.sh"
+ err "Automatic Docker install is not supported on Windows."
+ ;;
+ *)
+ err "Unsupported OS. Install Docker manually: https://docs.docker.com/engine/install/"
+ ;;
+ esac
+}
+
+wait_for_docker_daemon() {
+ max_wait="$1"
+ printf " Waiting for Docker daemon..."
+ i=0
+ while [ "$i" -lt "$max_wait" ]; do
+ if docker info < /dev/null >/dev/null 2>&1; then
+ echo ""
+ return 0
+ fi
+ printf "."
+ sleep 2
+ i=$((i + 1))
+ done
+ echo ""
+ return 1
+}
-step "2. Docker"
+start_docker_daemon() {
+ case "$(uname -s)" in
+ Darwin)
+ if [ -d "/Applications/Docker.app" ]; then
+ echo " Starting Docker Desktop..."
+ open -g -a Docker
+ osascript -e 'tell application "Docker" to activate' 2>/dev/null || true
+ if ! wait_for_docker_daemon 15; then
+ echo ""
+ echo " ┌─────────────────────────────────────────────────────────────┐"
+ echo " │ Docker Desktop needs you to complete setup in its window. │"
+ echo " │ │"
+ echo " │ 1. Accept the Docker Desktop license agreement │"
+ echo " │ 2. Skip or complete sign-in (sign-in is optional) │"
+ echo " │ 3. Wait for the engine to finish starting │"
+ echo " │ (whale icon in menu bar stops animating) │"
+ echo " │ │"
+ echo " │ This installer will continue automatically once ready. │"
+ echo " └─────────────────────────────────────────────────────────────┘"
+ echo ""
+ if ! wait_for_docker_daemon 150; then
+ return 1
+ fi
+ fi
+ fi
+ ;;
+ Linux)
+ if command -v systemctl >/dev/null 2>&1; then
+ echo " Starting Docker daemon..."
+ sudo systemctl start docker < /dev/null 2>/dev/null || true
+ sleep 2
+ fi
+ if ! docker info < /dev/null >/dev/null 2>&1; then
+ if sudo docker info < /dev/null >/dev/null 2>&1; then
+ echo " Docker requires sudo (group not yet active). Using sudo for this session."
+ dc() { sudo docker compose "$@"; }
+ fi
+ fi
+ ;;
+ esac
+}
if [ "${IX_SKIP_BACKEND:-}" = "1" ]; then
echo " (skipped via IX_SKIP_BACKEND=1)"
else
- if command -v docker >/dev/null 2>&1; then
- info "Docker is installed"
+ # Find docker binary by absolute path — command -v breaks in piped sh
+ find_docker() {
+ for p in /usr/local/bin/docker /opt/homebrew/bin/docker /usr/bin/docker; do
+ if [ -x "$p" ]; then echo "$p"; return; fi
+ done
+ }
+
+ DOCKER_BIN="$(find_docker)"
+
+ # Already installed and running? Skip everything.
+ if [ -n "$DOCKER_BIN" ] && "$DOCKER_BIN" info < /dev/null >/dev/null 2>&1; then
+ info "Docker is ready"
+ export PATH="/usr/local/bin:$PATH"
+ dc() { "$DOCKER_BIN" compose "$@"; }
+
else
- echo ""
- echo " Docker is required to run the Ix backend (ArangoDB + Memory Layer)."
- echo ""
- case "$(uname -s)" in
- Darwin)
- echo " Install Docker Desktop for macOS:"
- echo " https://docs.docker.com/desktop/install/mac-install/"
- echo ""
- echo " Or via Homebrew:"
- echo " brew install --cask docker"
- ;;
- Linux)
- echo " Install Docker Engine:"
- echo " https://docs.docker.com/engine/install/"
- echo ""
- echo " Quick install:"
- echo " curl -fsSL https://get.docker.com | sh"
- ;;
- MINGW*|MSYS*|CYGWIN*)
- echo " Install Docker Desktop for Windows:"
- echo " https://docs.docker.com/desktop/install/windows-install/"
- ;;
- esac
- echo ""
- echo " To install the CLI only (no backend):"
- echo " IX_SKIP_BACKEND=1 sh install.sh"
- echo ""
- err "Install Docker and re-run, or set IX_SKIP_BACKEND=1 to skip."
- fi
+ # Install if binary doesn't exist at all
+ if [ -z "$DOCKER_BIN" ] && ! [ -d "/Applications/Docker.app" ]; then
+ install_docker
+ DOCKER_BIN="$(find_docker)"
+ fi
- if ! docker info < /dev/null >/dev/null 2>&1; then
- echo ""
- echo " Docker is installed but not running."
+ # macOS: launch Docker Desktop and wait for daemon
case "$(uname -s)" in
Darwin)
- echo " Trying to start Docker Desktop..."
if [ -d "/Applications/Docker.app" ]; then
+ # Docker Desktop installed but daemon not running — just start it
+ echo " Starting Docker Desktop..."
open -a Docker
- echo " Waiting for Docker to start (this can take 30-60 seconds)..."
+ osascript -e 'tell application "Docker" to activate' 2>/dev/null || true
+
+ printf " Waiting for Docker to be ready..."
i=0
- while [ "$i" -lt 30 ]; do
- if docker info < /dev/null >/dev/null 2>&1; then break; fi
- printf "."
- sleep 2
- i=$((i + 1))
+ ready=0
+ while [ "$i" -lt 60 ]; do
+ DOCKER_BIN="$(find_docker)"
+ if [ -n "$DOCKER_BIN" ] && "$DOCKER_BIN" info < /dev/null >/dev/null 2>&1; then
+ ready=1; break
+ fi
+ printf "."; sleep 2; i=$((i + 1))
done
echo ""
+
+ # Only show license prompt if still not ready after 2 minutes
+ if [ "$ready" = "0" ]; then
+ osascript -e 'tell application "Docker" to activate' 2>/dev/null || true
+ echo ""
+ echo " ┌─────────────────────────────────────────────────────────────┐"
+ echo " │ Docker Desktop needs you to complete setup in its window: │"
+ echo " │ │"
+ echo " │ 1. Accept the license agreement (if shown) │"
+ echo " │ 2. Skip sign-in (or sign in — it is optional) │"
+ echo " │ 3. Wait for the engine to start │"
+ echo " │ │"
+ echo " │ This installer will continue automatically. │"
+ echo " └─────────────────────────────────────────────────────────────┘"
+ echo ""
+ printf " Waiting..."
+ while [ "$i" -lt 180 ]; do
+ DOCKER_BIN="$(find_docker)"
+ if [ -n "$DOCKER_BIN" ] && "$DOCKER_BIN" info < /dev/null >/dev/null 2>&1; then
+ ready=1; break
+ fi
+ printf "."; sleep 2; i=$((i + 1))
+ done
+ echo ""
+ fi
+
+ # Wire up docker for rest of script
+ DOCKER_BIN="$(find_docker)"
+ if [ -n "$DOCKER_BIN" ]; then
+ export PATH="/usr/local/bin:$PATH"
+ dc() { "$DOCKER_BIN" compose "$@"; }
+ fi
fi
;;
+ Linux)
+ if [ -n "$DOCKER_BIN" ] && ! "$DOCKER_BIN" info < /dev/null >/dev/null 2>&1; then
+ if command -v systemctl >/dev/null 2>&1; then
+ echo " Starting Docker daemon..."
+ sudo systemctl start docker < /dev/null 2>/dev/null || true
+ sleep 2
+ fi
+ if ! "$DOCKER_BIN" info < /dev/null >/dev/null 2>&1; then
+ if sudo "$DOCKER_BIN" info < /dev/null >/dev/null 2>&1; then
+ echo " Docker requires sudo (group not yet active). Using sudo for this session."
+ dc() { sudo "$DOCKER_BIN" compose "$@"; }
+ fi
+ fi
+ fi
+ ;;
+ MINGW*|MSYS*|CYGWIN*)
+ # Windows: docker should be in PATH after Docker Desktop install
+ DOCKER_BIN="$(find_docker)"
+ if [ -z "$DOCKER_BIN" ] && command -v docker >/dev/null 2>&1; then
+ DOCKER_BIN="docker"
+ fi
+ ;;
esac
- if ! docker info < /dev/null >/dev/null 2>&1; then
- err "Docker is not running. Start Docker and re-run this installer."
+ # Final check
+ DOCKER_BIN="$(find_docker)"
+ if [ -z "$DOCKER_BIN" ]; then
+ err "Docker not found. Restart your terminal and re-run this installer."
fi
+ if ! "$DOCKER_BIN" info < /dev/null >/dev/null 2>&1; then
+ err "Docker is not running. Start Docker Desktop and re-run this installer."
+ fi
+ info "Docker is ready"
+
+ if ! "$DOCKER_BIN" compose version >/dev/null 2>&1; then
+ err "Docker Compose v2 is required. Update Docker or install the compose plugin."
+ fi
+ info "Docker Compose $("$DOCKER_BIN" compose version --short 2>/dev/null || echo 'v2') is available"
fi
- info "Docker is running"
fi
# -- Step 3: Start Backend --
@@ -384,19 +697,57 @@ else
_download "${GITHUB_RAW}/docker-compose.standalone.yml" "$COMPOSE_DIR/docker-compose.yml"
info "Downloaded docker-compose.yml"
- printf " Starting backend services (this may take a minute on first run)..."
- dc -f "$COMPOSE_DIR/docker-compose.yml" up -d --pull always < /dev/null >/dev/null 2>&1 &
- DOCKER_PID=$!
- while kill -0 "$DOCKER_PID" 2>/dev/null; do
+ # Pull images first so we catch rate limits / auth errors clearly
+ echo " Pulling Docker images (this may take a few minutes on first run)..."
+ PULL_LOG=$(mktemp /tmp/ix-pull-XXXXXX.log)
+ dc -f "$COMPOSE_DIR/docker-compose.yml" pull < /dev/null >"$PULL_LOG" 2>&1 &
+ PULL_PID=$!
+ while kill -0 "$PULL_PID" 2>/dev/null; do
printf "."
- sleep 1
+ sleep 2
done
- wait "$DOCKER_PID" || true
echo ""
+ if ! wait "$PULL_PID"; then
+ echo ""
+ if grep -qi "toomanyrequests\|rate limit\|429\|unauthorized\|denied" "$PULL_LOG" 2>/dev/null; then
+ echo " ┌─────────────────────────────────────────────────────────────┐"
+ echo " │ Docker image pull was rate-limited or denied. │"
+ echo " │ │"
+ echo " │ Docker Hub limits unauthenticated pulls to 100 per 6hrs. │"
+ echo " │ Sign in to Docker Hub (free account) to raise the limit: │"
+ echo " │ │"
+ echo " │ docker login │"
+ echo " │ │"
+ echo " │ Then re-run this installer. │"
+ echo " └─────────────────────────────────────────────────────────────┘"
+ else
+ echo " Image pull failed. Error output:"
+ head -20 "$PULL_LOG"
+ echo ""
+ echo " If Docker just started, it may need a moment — try again."
+ fi
+ rm -f "$PULL_LOG"
+ err "Failed to pull Docker images."
+ fi
+ rm -f "$PULL_LOG"
+ info "Docker images pulled"
+
+ # Start services
+ printf " Starting backend services..."
+ START_LOG=$(mktemp /tmp/ix-start-XXXXXX.log)
+ if ! dc -f "$COMPOSE_DIR/docker-compose.yml" up -d < /dev/null >"$START_LOG" 2>&1; then
+ echo ""
+ echo " Failed to start backend. Error output:"
+ head -20 "$START_LOG"
+ rm -f "$START_LOG"
+ err "docker compose up failed."
+ fi
+ rm -f "$START_LOG"
+ echo " started"
printf " Waiting for services to become healthy..."
i=0
- while [ "$i" -lt 30 ]; do
+ while [ "$i" -lt 45 ]; do
if _fetch "$HEALTH_URL" >/dev/null 2>&1 && _fetch "$ARANGO_URL" >/dev/null 2>&1; then
break
fi