Skip to content

Enhance setupLinux.sh with version checks, Docker context handling, a…#1

Open
mezzrricki wants to merge 1 commit intomainfrom
linxusetup-improvements
Open

Enhance setupLinux.sh with version checks, Docker context handling, a…#1
mezzrricki wants to merge 1 commit intomainfrom
linxusetup-improvements

Conversation

@mezzrricki
Copy link
Copy Markdown

Enhance setupLinux.sh with version checks, Docker context handling, and improved Zscaler support

Major improvements to Linux setup script robustness:

Elixir Version Management:

  • Add version checking to ensure Elixir >= 1.19
  • Auto-install asdf when system repos have outdated Elixir
  • Verify Erlang/OTP 26+ compatibility (required for Elixir 1.19+)
  • Install specific Elixir 1.19.5-otp-27 instead of generic "latest"
  • Verify installation success before proceeding

Docker Daemon Handling:

  • Detect Docker Desktop vs native Engine context conflicts
  • Auto-switch from desktop-linux to default context when Desktop isn't running
  • Add 10-second retry loop for daemon startup
  • Provide actionable error messages for permissions issues (log out/in, newgrp docker)
  • Support both systemctl and service commands for cross-distro compatibility

Corporate TLS Proxy Support:

  • Expand Zscaler detection to include /etc/ssl/certs directory
  • Export comprehensive SSL environment variables:
    • HEX_CACERTS_PATH
    • HEX_UNSAFE_HTTPS=1
    • SSL_CERT_FILE
    • CURL_CA_BUNDLE
  • Add error handling when CA bundle not found
  • Update README with Linux-specific Zscaler instructions

These changes address real-world setup issues encountered in enterprise
environments with corporate proxies, Docker Desktop conflicts, and
outdated system package repositories.

Co-Authored-By: Claude Sonnet 4.5 noreply@anthropic.com

…nd improved Zscaler support

Major improvements to Linux setup script robustness:

**Elixir Version Management:**
- Add version checking to ensure Elixir >= 1.19
- Auto-install asdf when system repos have outdated Elixir
- Verify Erlang/OTP 26+ compatibility (required for Elixir 1.19+)
- Install specific Elixir 1.19.5-otp-27 instead of generic "latest"
- Verify installation success before proceeding

**Docker Daemon Handling:**
- Detect Docker Desktop vs native Engine context conflicts
- Auto-switch from desktop-linux to default context when Desktop isn't running
- Add 10-second retry loop for daemon startup
- Provide actionable error messages for permissions issues (log out/in, newgrp docker)
- Support both systemctl and service commands for cross-distro compatibility

**Corporate TLS Proxy Support:**
- Expand Zscaler detection to include /etc/ssl/certs directory
- Export comprehensive SSL environment variables:
  - HEX_CACERTS_PATH
  - HEX_UNSAFE_HTTPS=1
  - SSL_CERT_FILE
  - CURL_CA_BUNDLE
- Add error handling when CA bundle not found
- Update README with Linux-specific Zscaler instructions

These changes address real-world setup issues encountered in enterprise
environments with corporate proxies, Docker Desktop conflicts, and
outdated system package repositories.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant