Skip to content

fix(install): shell-safe one-liner (curl | bash)#64

Merged
saadqbal merged 1 commit into
mainfrom
fix/install-oneliner-shell-safe
Jul 22, 2026
Merged

fix(install): shell-safe one-liner (curl | bash)#64
saadqbal merged 1 commit into
mainfrom
fix/install-oneliner-shell-safe

Conversation

@LukasWodka

@LukasWodka LukasWodka commented Jul 22, 2026

Copy link
Copy Markdown
Contributor

The docs' bash <(curl …) breaks under /bin/sh=dash (Debian/Ubuntu default) with Syntax error: "(" unexpected — hit live during a Charité install. Switches all 7 install snippets to curl -fsSL tracebloc.io/i.sh | bash (works from any shell; the installer already supports it). Env-var + --diagnose variants converted correctly. Docs → main per the docs exemption.

Backlog: A1.

🤖 Generated with Claude Code


Note

Low Risk
Documentation-only wording in install snippets; no installer or application code changes.

Overview
Replaces bash <(curl -fsSL https://tracebloc.io/i.sh) with curl -fsSL https://tracebloc.io/i.sh | bash everywhere the macOS/Linux installer is documented (seven MDX files: quickstart, setup guide, deploy-local, configuration, troubleshooting, prepare-dataset note, and overview).

The process-substitution form breaks when users run it under /bin/sh (e.g. dash on Debian/Ubuntu) with a ( syntax error; the pipe form matches what the installer already supports.

Env-var overrides use the prefix form curl … | CLUSTER_NAME=… AGENTS=… bash. Diagnostics use curl … | bash -s -- --diagnose instead of appending --diagnose to the old one-liner.

Reviewed by Cursor Bugbot for commit 6cc0857. Bugbot is set up for automated code reviews on this repo. Configure here.

…rl …)

`bash <(curl …)` uses bash process substitution, which /bin/sh (dash — the
default on Debian/Ubuntu) can't parse: it errors "Syntax error: \"(\"
unexpected" before anything downloads. Switch all install snippets to
`curl -fsSL tracebloc.io/i.sh | bash`, which works from any shell and is the
form the installer already supports (it reads prompts from /dev/tty).

Variants handled: env-var prefixes move after the pipe (… | VAR=x bash) and
args use `bash -s -- --diagnose`. 7 pages: quickstart, deploy-local,
configuration, setup-guide, troubleshooting, prepare-dataset, overview.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@mintlify

mintlify Bot commented Jul 22, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
tracebloc 🟢 Ready View Preview Jul 22, 2026, 1:10 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@mintlify

mintlify Bot commented Jul 22, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
tracebloc 🟡 Building Jul 22, 2026, 1:08 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@saadqbal
saadqbal merged commit a6b9574 into main Jul 22, 2026
7 checks passed
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.

2 participants