# Clusterflux Getting Started

Use the public repository and release downloads with the hosted coordinator at
`https://clusterflux.lesstuff.com`.

## DNS

`clusterflux.lesstuff.com` should resolve through public DNS. If it
does not resolve yet, wait for DNS propagation or use the fallback hosts
entry supplied with the invitation.

## Install

1. Download the binary archive for your platform from the Forgejo release.
2. Check the archive against `SHA256SUMS`.
3. Extract it and put `bin/` on your `PATH`.
4. Install `clusterflux-vscode-*.vsix` when you want the VS Code debugger:

```bash
code --install-extension clusterflux-vscode-*.vsix
```

## Sign in and run

```bash
clusterflux login --browser
clusterflux auth status
clusterflux project list
clusterflux bundle inspect --project examples/hello-build
```

The CLI opens the server-provided Authentik authorization URL. State, nonce,
PKCE, provider code exchange, and userinfo remain on the hosted service. The CLI
stores only the resulting scoped Clusterflux session.

Create a node enrollment grant, attach the node, and start the worker:

```bash
clusterflux node enroll --project-id <project-id> --json
clusterflux node attach --project-id <project-id> --node workstation \
  --enrollment-grant "$ENROLLMENT_GRANT"
clusterflux-node --coordinator https://clusterflux.lesstuff.com \
  --tenant <tenant> --project-id <project-id> --node workstation \
  --project-root "$PWD" --worker --emit-ready
```

Then run the workflow:

```bash
clusterflux run --project examples/hello-build build
```

Public tree identity: `sha256:4f0b7cd828932c06d56f2406788f89b2050ef56c1e1a4f76f55341d387d78e46`
Release name: `release-501cb6d672f9`