Skip to content

Add an install guide for the one-line script - #213

Merged
rbardaji merged 2 commits into
mainfrom
docs/install-script-guide
Aug 4, 2026
Merged

Add an install guide for the one-line script#213
rbardaji merged 2 commits into
mainfrom
docs/install-script-guide

Conversation

@rbardaji

Copy link
Copy Markdown
Collaborator

Closes #212

Adds an operator-facing guide for installing an Endpoint with the script — the way we actually do it now — and links it from the README Quick Start.

What's in it

docs/installing-with-the-script.md:

  • The one-liner: bash <(curl -fsSL https://bit.ly/ndp-ep), with a note to use the <(...) form so prompts stay interactive.
  • Prerequisites (Docker, git/curl/python3, an NDP access token, HTTPS for identity-provider sign-in).
  • What the installer asks, and registering with the Federation.
  • A section per catalog option — MongoDB installed or existing, CKAN installed or existing — each with a placeholder for a screen recording (📹 Recording: coming soon).
  • Optional features (JupyterHub, streaming, remote execution).
  • After installing, and a few command-line flags for unattended / repeat runs.

The README Quick Start now leads with the script and keeps the manual Docker setup for development.

Docs only — no code changes.

Raul Bardaji added 2 commits July 27, 2026 12:09
Walk through 'bash <(curl -fsSL https://bit.ly/ndp-ep)': prerequisites,
registering with the Federation, and each catalog option (MongoDB
installed or existing, CKAN installed or existing) plus the optional
features, each with a placeholder for a screen recording. Link it from
the README Quick Start so the script route is the first thing an operator
sees, with the manual Docker setup kept for development.

Refs #212
The guide described the installer as it was on 27 July. Since then the catalog
question gained a fifth answer — no local catalog, now the first and the
default — and the identity-provider sign-in question was removed, because no
client an Endpoint can use exists yet.

Documenting a prompt that is not there sends people looking for it, so the
five options are listed with 'None' first, the sign-in mentions are gone from
the prerequisites, the walk-through and the after-installing section, and the
standalone no-catalog sequence diagram is linked from the end.

Version renumbered from 0.33.6 to 0.34.4, two releases having shipped while
this sat open.
@rbardaji
rbardaji force-pushed the docs/install-script-guide branch from 5f9c1b4 to 8b53e97 Compare August 4, 2026 10:41
@rbardaji
rbardaji merged commit b08478c into main Aug 4, 2026
1 check passed
@rbardaji
rbardaji deleted the docs/install-script-guide branch August 4, 2026 10:43
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.

Add a user guide for installing an Endpoint with the script

1 participant