Skip to content

armgit / xerj

Public Imported from GitHub
0

AI search engine and MCP server for bots and agents. One Rust binary indexes code, docs, logs, JSONL/CSV and PDFs for BM25 full-text, vector and hybrid search, code search without grep, agent memory and RAG. Elasticsearch-compatible API; Corpus Hub serves hundreds of reference memory corpora.

site(install): full OS/CPU installer matrix + review-hardened scripts + honest install docs

xerj-orgb0f1eae823a5
diff --git a/landing/_headers b/landing/_headers
index 21a263ff7..5783cb288 100644
--- a/landing/_headers
+++ b/landing/_headers
@@ -37,3 +37,8 @@
/get
Content-Type: text/plain; charset=utf-8
Cache-Control: public, max-age=300
+
+# Windows installer: powershell -ExecutionPolicy Bypass -c "irm https://xerj.org/get.ps1 | iex"
+/get.ps1
+ Content-Type: text/plain; charset=utf-8
+ Cache-Control: public, max-age=300
diff --git a/landing/docs/aggregations.html b/landing/docs/aggregations.html
index f85cfd0c1..1f462ee84 100644
--- a/landing/docs/aggregations.html
+++ b/landing/docs/aggregations.html
@@ -24,7 +24,7 @@
<span class="spacer"></span>
<a href="/docs/index.html" class="active">DOCS</a>
<a href="/playground.html">DASHBOARDS</a>
- <a href="https://github.com/" rel="external">GITHUB</a>
+ <a href="https://github.com/xerj-org/xerj" rel="external">GITHUB</a>
<span class="spacer"></span>
<span class="theme">
<button type="button" data-theme="day">DAY</button>
@@ -161,7 +161,7 @@
</div>
<footer class="footer">
- <span>XERJ.AI · DOCS · V0.1</span>
+ <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>
<span>READ THE SOURCE</span>
<span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a></span>
</footer>
diff --git a/landing/docs/analyzers.html b/landing/docs/analyzers.html
index 2644da8b1..2b8596636 100644
--- a/landing/docs/analyzers.html
+++ b/landing/docs/analyzers.html
@@ -24,7 +24,7 @@
<span class="spacer"></span>
<a href="/docs/index.html" class="active">DOCS</a>
<a href="/playground.html">DASHBOARDS</a>
- <a href="https://github.com/" rel="external">GITHUB</a>
+ <a href="https://github.com/xerj-org/xerj" rel="external">GITHUB</a>
<span class="spacer"></span>
<span class="theme">
<button type="button" data-theme="day">DAY</button>
@@ -143,7 +143,7 @@
</div>
<footer class="footer">
- <span>XERJ.AI · DOCS · V0.1</span>
+ <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>
<span>READ THE SOURCE</span>
<span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a></span>
</footer>
diff --git a/landing/docs/api-es-compat.html b/landing/docs/api-es-compat.html
index 34dab2381..7eee163a1 100644
--- a/landing/docs/api-es-compat.html
+++ b/landing/docs/api-es-compat.html
@@ -24,7 +24,7 @@
<span class="spacer"></span>
<a href="/docs/index.html" class="active">DOCS</a>
<a href="/playground.html">DASHBOARDS</a>
- <a href="https://github.com/" rel="external">GITHUB</a>
+ <a href="https://github.com/xerj-org/xerj" rel="external">GITHUB</a>
<span class="spacer"></span>
<span class="theme">
<button type="button" data-theme="day">DAY</button>
@@ -186,7 +186,7 @@ JSON</pre>
</div>
<footer class="footer">
- <span>XERJ.AI · DOCS · V0.1</span>
+ <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>
<span>READ THE SOURCE</span>
<span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a></span>
</footer>
diff --git a/landing/docs/api-native.html b/landing/docs/api-native.html
index 0b318881a..14ec3c6ce 100644
--- a/landing/docs/api-native.html
+++ b/landing/docs/api-native.html
@@ -24,7 +24,7 @@
<span class="spacer"></span>
<a href="/docs/index.html" class="active">DOCS</a>
<a href="/playground.html">DASHBOARDS</a>
- <a href="https://github.com/" rel="external">GITHUB</a>
+ <a href="https://github.com/xerj-org/xerj" rel="external">GITHUB</a>
<span class="spacer"></span>
<span class="theme">
<button type="button" data-theme="day">DAY</button>
@@ -198,7 +198,7 @@
</div>
<footer class="footer">
- <span>XERJ.AI · DOCS · V0.1</span>
+ <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>
<span>READ THE SOURCE</span>
<span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a></span>
</footer>
diff --git a/landing/docs/backup-restore.html b/landing/docs/backup-restore.html
index 197e605ba..978f38aa2 100644
--- a/landing/docs/backup-restore.html
+++ b/landing/docs/backup-restore.html
@@ -24,7 +24,7 @@
<span class="spacer"></span>
<a href="/docs/index.html" class="active">DOCS</a>
<a href="/playground.html">DASHBOARDS</a>
- <a href="https://github.com/" rel="external">GITHUB</a>
+ <a href="https://github.com/xerj-org/xerj" rel="external">GITHUB</a>
<span class="spacer"></span>
<span class="theme">
<button type="button" data-theme="day">DAY</button>
@@ -183,7 +183,7 @@ $ curl -sXPOST .../v1/cluster/nodes/b/activate</pre>
</div>
<footer class="footer">
- <span>XERJ.AI · DOCS · V0.1</span>
+ <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>
<span>READ THE SOURCE</span>
<span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a></span>
</footer>
diff --git a/landing/docs/cli.html b/landing/docs/cli.html
index c78a6e925..389f18872 100644
--- a/landing/docs/cli.html
+++ b/landing/docs/cli.html
@@ -24,7 +24,7 @@
<span class="spacer"></span>
<a href="/docs/index.html" class="active">DOCS</a>
<a href="/playground.html">DASHBOARDS</a>
- <a href="https://github.com/" rel="external">GITHUB</a>
+ <a href="https://github.com/xerj-org/xerj" rel="external">GITHUB</a>
<span class="spacer"></span>
<span class="theme">
<button type="button" data-theme="day">DAY</button>
@@ -148,7 +148,7 @@ OPTIONS:
</div>
<footer class="footer">
- <span>XERJ.AI · DOCS · V0.1</span>
+ <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>
<span>READ THE SOURCE</span>
<span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a></span>
</footer>
diff --git a/landing/docs/clustering.html b/landing/docs/clustering.html
index 2e8a770a5..a12ff4d99 100644
--- a/landing/docs/clustering.html
+++ b/landing/docs/clustering.html
@@ -24,7 +24,7 @@
<span class="spacer"></span>
<a href="/docs/index.html" class="active">DOCS</a>
<a href="/playground.html">DASHBOARDS</a>
- <a href="https://github.com/" rel="external">GITHUB</a>
+ <a href="https://github.com/xerj-org/xerj" rel="external">GITHUB</a>
<span class="spacer"></span>
<span class="theme">
<button type="button" data-theme="day">DAY</button>
@@ -238,7 +238,7 @@ $ curl -sXPOST -H "Authorization: ApiKey $XERJ_API_KEY" \
</div>
<footer class="footer">
- <span>XERJ.AI · DOCS · V0.1</span>
+ <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>
<span>READ THE SOURCE</span>
<span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a></span>
</footer>
diff --git a/landing/docs/compression.html b/landing/docs/compression.html
index 708363f30..a9dc7fdd4 100644
--- a/landing/docs/compression.html
+++ b/landing/docs/compression.html
@@ -24,7 +24,7 @@
<span class="spacer"></span>
<a href="/docs/index.html" class="active">DOCS</a>
<a href="/playground.html">DASHBOARDS</a>
- <a href="https://github.com/" rel="external">GITHUB</a>
+ <a href="https://github.com/xerj-org/xerj" rel="external">GITHUB</a>
<span class="spacer"></span>
<span class="theme">
<button type="button" data-theme="day">DAY</button>
@@ -145,7 +145,7 @@
</div>
<footer class="footer">
- <span>XERJ.AI · DOCS · V0.1</span>
+ <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>
<span>READ THE SOURCE</span>
<span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a></span>
</footer>
diff --git a/landing/docs/config.html b/landing/docs/config.html
index beae5323f..436fbcb2c 100644
--- a/landing/docs/config.html
+++ b/landing/docs/config.html
@@ -24,7 +24,7 @@
<span class="spacer"></span>
<a href="/docs/index.html" class="active">DOCS</a>
<a href="/playground.html">DASHBOARDS</a>
- <a href="https://github.com/" rel="external">GITHUB</a>
+ <a href="https://github.com/xerj-org/xerj" rel="external">GITHUB</a>
<span class="spacer"></span>
<span class="theme">
<button type="button" data-theme="day">DAY</button>
@@ -240,7 +240,7 @@ tick_ms = 50</pre>
</div>
<footer class="footer">
- <span>XERJ.AI · DOCS · V0.1</span>
+ <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>
<span>READ THE SOURCE</span>
<span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a></span>
</footer>
diff --git a/landing/docs/env.html b/landing/docs/env.html
index 47e6ea28d..3f5763e16 100644
--- a/landing/docs/env.html
+++ b/landing/docs/env.html
@@ -24,7 +24,7 @@
<span class="spacer"></span>
<a href="/docs/index.html" class="active">DOCS</a>
<a href="/playground.html">DASHBOARDS</a>
- <a href="https://github.com/" rel="external">GITHUB</a>
+ <a href="https://github.com/xerj-org/xerj" rel="external">GITHUB</a>
<span class="spacer"></span>
<span class="theme">
<button type="button" data-theme="day">DAY</button>
@@ -142,7 +142,7 @@
</div>
<footer class="footer">
- <span>XERJ.AI · DOCS · V0.1</span>
+ <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>
<span>READ THE SOURCE</span>
<span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a></span>
</footer>
diff --git a/landing/docs/index.html b/landing/docs/index.html
index fe7aab650..dc803e011 100644
--- a/landing/docs/index.html
+++ b/landing/docs/index.html
@@ -24,7 +24,7 @@
<span class="spacer"></span>
<a href="/docs/index.html" class="active">DOCS</a>
<a href="/playground.html">DASHBOARDS</a>
- <a href="https://github.com/" rel="external">GITHUB</a>
+ <a href="https://github.com/xerj-org/xerj" rel="external">GITHUB</a>
<span class="spacer"></span>
<span class="theme">
<button type="button" data-theme="day">DAY</button>
@@ -198,7 +198,7 @@
</div>
<footer class="footer">
- <span>XERJ.AI · DOCS · V0.1</span>
+ <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>
<span>READ THE SOURCE</span>
<span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a></span>
</footer>
diff --git a/landing/docs/ingest.html b/landing/docs/ingest.html
index 29f0290d6..f719c7792 100644
--- a/landing/docs/ingest.html
+++ b/landing/docs/ingest.html
@@ -24,7 +24,7 @@
<span class="spacer"></span>
<a href="/docs/index.html" class="active">DOCS</a>
<a href="/playground.html">DASHBOARDS</a>
- <a href="https://github.com/" rel="external">GITHUB</a>
+ <a href="https://github.com/xerj-org/xerj" rel="external">GITHUB</a>
<span class="spacer"></span>
<span class="theme">
<button type="button" data-theme="day">DAY</button>
@@ -149,7 +149,7 @@
</div>
<footer class="footer">
- <span>XERJ.AI · DOCS · V0.1</span>
+ <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>
<span>READ THE SOURCE</span>
<span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a></span>
</footer>
diff --git a/landing/docs/install.html b/landing/docs/install.html
index 2f83efdf4..d2682f71b 100644
--- a/landing/docs/install.html
+++ b/landing/docs/install.html
@@ -24,7 +24,7 @@
<span class="spacer"></span>
<a href="/docs/index.html" class="active">DOCS</a>
<a href="/playground.html">DASHBOARDS</a>
- <a href="https://github.com/" rel="external">GITHUB</a>
+ <a href="https://github.com/xerj-org/xerj" rel="external">GITHUB</a>
<span class="spacer"></span>
<span class="theme">
<button type="button" data-theme="day">DAY</button>
@@ -106,17 +106,28 @@
<h2>System requirements</h2>
<ul>
- <li><strong>OS:</strong> Linux (glibc ≥ 2.31) or macOS (Darwin arm64 / x86_64).</li>
+ <li><strong>OS:</strong> Linux (any distro — the Linux build is fully static musl, Alpine included), macOS (Apple Silicon arm64 / Intel x86_64), or Windows 10+ (x64 / ARM64).</li>
<li><strong>RAM:</strong> 400 MB idle. 2 GB working set per active index. Scales linearly with segment resident set.</li>
<li><strong>Disk:</strong> Any fs that supports <code class="inline">fsync</code> and mmap. Prefer SSD.</li>
<li><strong>CPU:</strong> x86_64 with AVX2 or arm64 with NEON. The release build uses SIMD for hot paths.</li>
<li><strong>Open files:</strong> 65536 ulimit is sufficient for most deployments.</li>
</ul>
- <h2>Download</h2>
-<pre class="code">$ curl -sLO https://xerj.dev/releases/xerj-0.1.0-linux-x86_64.tar.gz
-$ tar xzf xerj-0.1.0-linux-x86_64.tar.gz
-$ sudo install -m 0755 xerj /usr/local/bin/xerj
+ <h2>Install with one command</h2>
+ <p>The installer detects your OS and CPU, downloads the matching release from <a href="https://github.com/xerj-org/xerj/releases">GitHub Releases</a>, and verifies its SHA-256.</p>
+ <p><strong>Linux / macOS</strong> (x86_64 and arm64):</p>
+<pre class="code">$ curl -fsSL https://xerj.org/get | sh</pre>
+ <p><strong>Windows</strong> (x64 and ARM64, PowerShell):</p>
+<pre class="code">&gt; powershell -ExecutionPolicy Bypass -c "irm https://xerj.org/get.ps1 | iex"</pre>
+
+ <h2>Manual download</h2>
+ <p>Every release publishes eight targets, each with a <code class="inline">.sha256</code> alongside: <code class="inline">x86_64</code>/<code class="inline">aarch64</code> × <code class="inline">unknown-linux-musl</code> (static, any distro), <code class="inline">unknown-linux-gnu</code>, <code class="inline">apple-darwin</code>, and <code class="inline">pc-windows-msvc</code> (.zip).</p>
+<pre class="code">$ ver=$(curl -fsSL https://api.github.com/repos/xerj-org/xerj/releases/latest | sed -n 's/.*"tag_name": *"v\([^"]*\)".*/\1/p')
+$ curl -fsSLO https://github.com/xerj-org/xerj/releases/download/v${ver}/xerj-${ver}-x86_64-unknown-linux-musl.tar.gz
+$ curl -fsSLO https://github.com/xerj-org/xerj/releases/download/v${ver}/xerj-${ver}-x86_64-unknown-linux-musl.tar.gz.sha256
+$ sha256sum -c xerj-${ver}-x86_64-unknown-linux-musl.tar.gz.sha256
+$ tar xzf xerj-${ver}-x86_64-unknown-linux-musl.tar.gz
+$ sudo install -m 0755 xerj-${ver}-x86_64-unknown-linux-musl/xerj /usr/local/bin/xerj
$ xerj --version</pre>
<h2>Write the config</h2>
@@ -128,22 +139,22 @@ bind_address = "0.0.0.0"
data_dir = "/var/lib/xerj"
[auth]
-enabled = true
-
-[tls]
-enabled = true
-cert_path = "/etc/xerj/certs/xerj.crt"
-key_path = "/etc/xerj/certs/xerj.key"</pre>
+enabled = true</pre>
+ <p>With <code class="inline">auth.enabled = true</code>, the first start prints an auto-generated admin API key and writes it to <code class="inline">&lt;data_dir&gt;/admin.key</code> — every native-API request (including health) must send it. In-process TLS is not wired yet (rustls integration is on the roadmap) — terminate TLS at a reverse proxy (nginx/caddy) in front of ports 8080/9200 for now.</p>
<h2>Run as a systemd unit</h2>
+ <p>Create the service user first — <code class="inline">StateDirectory</code> then gives it <code class="inline">/var/lib/xerj</code> automatically:</p>
+<pre class="code">$ sudo useradd -r -s /usr/sbin/nologin xerj</pre>
<pre class="code"># /etc/systemd/system/xerj.service
[Unit]
Description=XERJ storage engine
+Wants=network-online.target
After=network-online.target
[Service]
User=xerj
Group=xerj
+StateDirectory=xerj
ExecStart=/usr/local/bin/xerj --config /etc/xerj/xerj.toml
Restart=on-failure
LimitNOFILE=65536
@@ -156,15 +167,16 @@ WantedBy=multi-user.target</pre>
<pre class="code">$ sudo systemctl daemon-reload
$ sudo systemctl enable --now xerj
$ sudo systemctl status xerj
-$ curl -s http://localhost:8080/v1/health</pre>
+$ curl -s -H "Authorization: ApiKey $(sudo cat /var/lib/xerj/admin.key)" \
+ http://localhost:8080/v1/health</pre>
<h2>Docker</h2>
- <p>Same binary, different shell. Useful for CI and for embedded dev.</p>
-<pre class="code">$ docker run -d --name xerj \
+ <p>No published image yet — build it locally from <code class="inline">engine/Dockerfile</code> (the image defaults to <code class="inline">--insecure --data-dir /data</code>, right for CI and local dev):</p>
+<pre class="code">$ docker build -t xerj:1.0.0-rc.1 engine/
+$ docker run -d --name xerj \
-p 8080:8080 -p 9200:9200 \
-v xerj-data:/data \
- -v $PWD/xerj.toml:/xerj.toml:ro \
- xerj:0.1.0 --config /xerj.toml</pre>
+ xerj:1.0.0-rc.1</pre>
<p class="source-note">Source · engine/README.md</p>
@@ -176,15 +188,15 @@ $ curl -s http://localhost:8080/v1/health</pre>
<!-- Print-only branded footer (hidden on screen, visible in PDF) -->
<div class="print-footer" style="display:none;">
- <span>XERJ.AI · V0.1 · 2026-04-16</span>
- <a href="https://xerj.dev/docs/">https://xerj.dev/docs/</a>
+ <span>XERJ.AI · V1.0.0-RC.1 · 2026-07-07</span>
+ <a href="https://xerj.org/docs/">https://xerj.org/docs/</a>
<span>Install</span>
</div>
</main>
</div>
<footer class="footer">
- <span>XERJ.AI · DOCS · V0.1</span>
+ <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>
<span>READ THE SOURCE</span>
<span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a></span>
</footer>
diff --git a/landing/docs/metrics.html b/landing/docs/metrics.html
index 10ee024f4..1e36dab3b 100644
--- a/landing/docs/metrics.html
+++ b/landing/docs/metrics.html
@@ -24,7 +24,7 @@
<span class="spacer"></span>
<a href="/docs/index.html" class="active">DOCS</a>
<a href="/playground.html">DASHBOARDS</a>
- <a href="https://github.com/" rel="external">GITHUB</a>
+ <a href="https://github.com/xerj-org/xerj" rel="external">GITHUB</a>
<span class="spacer"></span>
<span class="theme">
<button type="button" data-theme="day">DAY</button>
@@ -159,7 +159,7 @@ scrape_configs:
</div>
<footer class="footer">
- <span>XERJ.AI · DOCS · V0.1</span>
+ <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>
<span>READ THE SOURCE</span>
<span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a></span>
</footer>
diff --git a/landing/docs/migration-from-es.html b/landing/docs/migration-from-es.html
index 7d11be775..f87337cb5 100644
--- a/landing/docs/migration-from-es.html
+++ b/landing/docs/migration-from-es.html
@@ -24,7 +24,7 @@
<span class="spacer"></span>
<a href="/docs/index.html" class="active">DOCS</a>
<a href="/playground.html">DASHBOARDS</a>
- <a href="https://github.com/" rel="external">GITHUB</a>
+ <a href="https://github.com/xerj-org/xerj" rel="external">GITHUB</a>
<span class="spacer"></span>
<span class="theme">
<button type="button" data-theme="day">DAY</button>
@@ -166,7 +166,7 @@ $ diff &lt;(curl -s http://es:9200/logs-2026-04/_search -d @q.json) \
</div>
<footer class="footer">
- <span>XERJ.AI · DOCS · V0.1</span>
+ <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>
<span>READ THE SOURCE</span>
<span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a></span>
</footer>
diff --git a/landing/docs/operations.html b/landing/docs/operations.html
index 788e47a4a..4275481b2 100644
--- a/landing/docs/operations.html
+++ b/landing/docs/operations.html
@@ -24,7 +24,7 @@
<span class="spacer"></span>
<a href="/docs/index.html" class="active">DOCS</a>
<a href="/playground.html">DASHBOARDS</a>
- <a href="https://github.com/" rel="external">GITHUB</a>
+ <a href="https://github.com/xerj-org/xerj" rel="external">GITHUB</a>
<span class="spacer"></span>
<span class="theme">
<button type="button" data-theme="day">DAY</button>
@@ -223,7 +223,7 @@ scrape_configs:
</div>
<footer class="footer">
- <span>XERJ.AI · DOCS · V0.1</span>
+ <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>
<span>READ THE SOURCE</span>
<span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a></span>
</footer>
diff --git a/landing/docs/playbooks/full-text.html b/landing/docs/playbooks/full-text.html
index c6642f88c..e433abc40 100644
--- a/landing/docs/playbooks/full-text.html
+++ b/landing/docs/playbooks/full-text.html
@@ -24,7 +24,7 @@
<span class="spacer"></span>
<a href="/docs/index.html" class="active">DOCS</a>
<a href="/playground.html">DASHBOARDS</a>
- <a href="https://github.com/" rel="external">GITHUB</a>
+ <a href="https://github.com/xerj-org/xerj" rel="external">GITHUB</a>
<span class="spacer"></span>
<span class="theme">
<button type="button" data-theme="day">DAY</button>
@@ -178,7 +178,7 @@
</div>
<footer class="footer">
- <span>XERJ.AI · DOCS · V0.1</span>
+ <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>
<span>READ THE SOURCE</span>
<span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a></span>
</footer>
diff --git a/landing/docs/playbooks/log-analytics.html b/landing/docs/playbooks/log-analytics.html
index cd4c9e9ad..ef9c619ec 100644
--- a/landing/docs/playbooks/log-analytics.html
+++ b/landing/docs/playbooks/log-analytics.html
@@ -24,7 +24,7 @@
<span class="spacer"></span>
<a href="/docs/index.html" class="active">DOCS</a>
<a href="/playground.html">DASHBOARDS</a>
- <a href="https://github.com/" rel="external">GITHUB</a>
+ <a href="https://github.com/xerj-org/xerj" rel="external">GITHUB</a>
<span class="spacer"></span>
<span class="theme">
<button type="button" data-theme="day">DAY</button>
@@ -186,7 +186,7 @@ time_partition = "1h"</pre>
</div>
<footer class="footer">
- <span>XERJ.AI · DOCS · V0.1</span>
+ <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>
<span>READ THE SOURCE</span>
<span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a></span>
</footer>
diff --git a/landing/docs/playbooks/observability.html b/landing/docs/playbooks/observability.html
index 930e85346..29db47356 100644
--- a/landing/docs/playbooks/observability.html
+++ b/landing/docs/playbooks/observability.html
@@ -24,7 +24,7 @@
<span class="spacer"></span>
<a href="/docs/index.html" class="active">DOCS</a>
<a href="/playground.html">DASHBOARDS</a>
- <a href="https://github.com/" rel="external">GITHUB</a>
+ <a href="https://github.com/xerj-org/xerj" rel="external">GITHUB</a>
<span class="spacer"></span>
<span class="theme">
<button type="button" data-theme="day">DAY</button>
@@ -184,7 +184,7 @@ $ OTEL_EXPORTER_OTLP_ENDPOINT=http://xerj:8080/v1/indices/traces/otlp \
</div>
<footer class="footer">
- <span>XERJ.AI · DOCS · V0.1</span>
+ <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>
<span>READ THE SOURCE</span>
<span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a></span>
</footer>
diff --git a/landing/docs/playbooks/siem.html b/landing/docs/playbooks/siem.html
index 77282cf24..0cec6bfdc 100644
--- a/landing/docs/playbooks/siem.html
+++ b/landing/docs/playbooks/siem.html
@@ -24,7 +24,7 @@
<span class="spacer"></span>
<a href="/docs/index.html" class="active">DOCS</a>
<a href="/playground.html">DASHBOARDS</a>
- <a href="https://github.com/" rel="external">GITHUB</a>
+ <a href="https://github.com/xerj-org/xerj" rel="external">GITHUB</a>
<span class="spacer"></span>
<span class="theme">
<button type="button" data-theme="day">DAY</button>
@@ -236,7 +236,7 @@
</div>
<footer class="footer">
- <span>XERJ.AI · DOCS · V0.1</span>
+ <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>
<span>READ THE SOURCE</span>
<span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a></span>
</footer>
diff --git a/landing/docs/playbooks/vector-search.html b/landing/docs/playbooks/vector-search.html
index b3e77bd08..a4e66467b 100644
--- a/landing/docs/playbooks/vector-search.html
+++ b/landing/docs/playbooks/vector-search.html
@@ -24,7 +24,7 @@
<span class="spacer"></span>
<a href="/docs/index.html" class="active">DOCS</a>
<a href="/playground.html">DASHBOARDS</a>
- <a href="https://github.com/" rel="external">GITHUB</a>
+ <a href="https://github.com/xerj-org/xerj" rel="external">GITHUB</a>
<span class="spacer"></span>
<span class="theme">
<button type="button" data-theme="day">DAY</button>
@@ -186,7 +186,7 @@ timeout_ms = 5000</pre>
</div>
<footer class="footer">
- <span>XERJ.AI · DOCS · V0.1</span>
+ <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>
<span>READ THE SOURCE</span>
<span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a></span>
</footer>
diff --git a/landing/docs/queries.html b/landing/docs/queries.html
index fc44c1f7e..8f80e73b0 100644
--- a/landing/docs/queries.html
+++ b/landing/docs/queries.html
@@ -24,7 +24,7 @@
<span class="spacer"></span>
<a href="/docs/index.html" class="active">DOCS</a>
<a href="/playground.html">DASHBOARDS</a>
- <a href="https://github.com/" rel="external">GITHUB</a>
+ <a href="https://github.com/xerj-org/xerj" rel="external">GITHUB</a>
<span class="spacer"></span>
<span class="theme">
<button type="button" data-theme="day">DAY</button>
@@ -182,7 +182,7 @@
</div>
<footer class="footer">
- <span>XERJ.AI · DOCS · V0.1</span>
+ <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>
<span>READ THE SOURCE</span>
<span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a></span>
</footer>
diff --git a/landing/docs/quickstart.html b/landing/docs/quickstart.html
index 37549b24c..03e1a454d 100644
--- a/landing/docs/quickstart.html
+++ b/landing/docs/quickstart.html
@@ -24,7 +24,7 @@
<span class="spacer"></span>
<a href="/docs/index.html" class="active">DOCS</a>
<a href="/playground.html">DASHBOARDS</a>
- <a href="https://github.com/" rel="external">GITHUB</a>
+ <a href="https://github.com/xerj-org/xerj" rel="external">GITHUB</a>
<span class="spacer"></span>
<span class="theme">
<button type="button" data-theme="day">DAY</button>
@@ -170,7 +170,7 @@ $ xerj --config xerj.toml --insecure --data-dir /tmp/xerj</pre>
</div>
<footer class="footer">
- <span>XERJ.AI · DOCS · V0.1</span>
+ <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>
<span>READ THE SOURCE</span>
<span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a></span>
</footer>
diff --git a/landing/docs/security.html b/landing/docs/security.html
index 758c1fb3e..627ce11f3 100644
--- a/landing/docs/security.html
+++ b/landing/docs/security.html
@@ -24,7 +24,7 @@
<span class="spacer"></span>
<a href="/docs/index.html" class="active">DOCS</a>
<a href="/playground.html">DASHBOARDS</a>
- <a href="https://github.com/" rel="external">GITHUB</a>
+ <a href="https://github.com/xerj-org/xerj" rel="external">GITHUB</a>
<span class="spacer"></span>
<span class="theme">
<button type="button" data-theme="day">DAY</button>
@@ -144,7 +144,7 @@ key_path = "/etc/xerj/certs/xerj.key"</pre>
</div>
<footer class="footer">
- <span>XERJ.AI · DOCS · V0.1</span>
+ <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>
<span>READ THE SOURCE</span>
<span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a></span>
</footer>
diff --git a/landing/docs/storage.html b/landing/docs/storage.html
index 625bf2ccc..b374e6581 100644
--- a/landing/docs/storage.html
+++ b/landing/docs/storage.html
@@ -24,7 +24,7 @@
<span class="spacer"></span>
<a href="/docs/index.html" class="active">DOCS</a>
<a href="/playground.html">DASHBOARDS</a>
- <a href="https://github.com/" rel="external">GITHUB</a>
+ <a href="https://github.com/xerj-org/xerj" rel="external">GITHUB</a>
<span class="spacer"></span>
<span class="theme">
<button type="button" data-theme="day">DAY</button>
@@ -165,7 +165,7 @@
</div>
<footer class="footer">
- <span>XERJ.AI · DOCS · V0.1</span>
+ <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>
<span>READ THE SOURCE</span>
<span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a></span>
</footer>
diff --git a/landing/docs/troubleshooting.html b/landing/docs/troubleshooting.html
index 3b463b419..a5730eb4b 100644
--- a/landing/docs/troubleshooting.html
+++ b/landing/docs/troubleshooting.html
@@ -24,7 +24,7 @@
<span class="spacer"></span>
<a href="/docs/index.html" class="active">DOCS</a>
<a href="/playground.html">DASHBOARDS</a>
- <a href="https://github.com/" rel="external">GITHUB</a>
+ <a href="https://github.com/xerj-org/xerj" rel="external">GITHUB</a>
<span class="spacer"></span>
<span class="theme">
<button type="button" data-theme="day">DAY</button>
@@ -176,7 +176,7 @@ contents:
</div>
<footer class="footer">
- <span>XERJ.AI · DOCS · V0.1</span>
+ <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>
<span>READ THE SOURCE</span>
<span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a></span>
</footer>
diff --git a/landing/docs/upgrades.html b/landing/docs/upgrades.html
index 6d3a31420..748288243 100644
--- a/landing/docs/upgrades.html
+++ b/landing/docs/upgrades.html
@@ -24,7 +24,7 @@
<span class="spacer"></span>
<a href="/docs/index.html" class="active">DOCS</a>
<a href="/playground.html">DASHBOARDS</a>
- <a href="https://github.com/" rel="external">GITHUB</a>
+ <a href="https://github.com/xerj-org/xerj" rel="external">GITHUB</a>
<span class="spacer"></span>
<span class="theme">
<button type="button" data-theme="day">DAY</button>
@@ -173,7 +173,7 @@ $ sudo systemctl start xerj</pre>
</div>
<footer class="footer">
- <span>XERJ.AI · DOCS · V0.1</span>
+ <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>
<span>READ THE SOURCE</span>
<span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a></span>
</footer>
diff --git a/landing/docs/vectors.html b/landing/docs/vectors.html
index fbfa0b3b7..2cc87ccba 100644
--- a/landing/docs/vectors.html
+++ b/landing/docs/vectors.html
@@ -24,7 +24,7 @@
<span class="spacer"></span>
<a href="/docs/index.html" class="active">DOCS</a>
<a href="/playground.html">DASHBOARDS</a>
- <a href="https://github.com/" rel="external">GITHUB</a>
+ <a href="https://github.com/xerj-org/xerj" rel="external">GITHUB</a>
<span class="spacer"></span>
<span class="theme">
<button type="button" data-theme="day">DAY</button>
@@ -181,7 +181,7 @@
</div>
<footer class="footer">
- <span>XERJ.AI · DOCS · V0.1</span>
+ <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>
<span>READ THE SOURCE</span>
<span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a></span>
</footer>
diff --git a/landing/get b/landing/get
index d0b075525..28ba4aad2 100644
--- a/landing/get
+++ b/landing/get
@@ -40,17 +40,22 @@ else
fi
# --- detect target triple ---------------------------------------------------
+# Supported matrix (8 release targets):
+# Linux x86_64 / aarch64 (static musl build - any distro incl. Alpine)
+# macOS x86_64 / arm64 (Apple Silicon)
+# Windows x64 / ARM64 (via Git Bash / MSYS here; native PowerShell:
+# powershell -ExecutionPolicy Bypass -c "irm https://xerj.org/get.ps1 | iex")
os=$(uname -s); arch=$(uname -m)
case "$os" in
Linux) plat="unknown-linux-gnu"; ext="tar.gz"; bin="xerj" ;;
Darwin) plat="apple-darwin"; ext="tar.gz"; bin="xerj" ;;
MINGW*|MSYS*|CYGWIN*) plat="pc-windows-msvc"; ext="zip"; bin="xerj.exe" ;;
- *) die "unsupported OS: $os" ;;
+ *) die "unsupported OS: $os (xerj ships Linux, macOS and Windows builds)" ;;
esac
case "$arch" in
x86_64|amd64) cpu="x86_64" ;;
aarch64|arm64) cpu="aarch64" ;;
- *) die "unsupported CPU: $arch" ;;
+ *) die "unsupported CPU: $arch (xerj ships x86_64/amd64 and aarch64/arm64 builds for Linux, macOS and Windows)" ;;
esac
# Linux: prefer the fully-static musl build (runs on any distro, incl. Alpine).
if [ "$os" = "Linux" ]; then plat="unknown-linux-musl"; fi
@@ -65,6 +70,8 @@ if [ "${XERJ_VERSION:-}" = "" ]; then
[ -n "$tag" ] || die "could not resolve latest release — set XERJ_VERSION=vX.Y.Z (see https://github.com/${REPO}/releases)"
else
tag="$XERJ_VERSION"
+ # Release tags are v-prefixed; accept XERJ_VERSION=1.0.0 too.
+ case "$tag" in v*) ;; *) tag="v$tag" ;; esac
fi
ver="${tag#v}"
info "installing xerj ${BOLD}${tag}${RST} for ${BOLD}${target}${RST}"
@@ -73,28 +80,45 @@ stage="xerj-${ver}-${target}"
asset="${stage}.${ext}"
base="https://github.com/${REPO}/releases/download/${tag}"
-tmp=$(mktemp -d 2>/dev/null || mktemp -d -t xerj)
+# The X-template form works on GNU, BSD/macOS, and busybox mktemp alike.
+tmp=$(mktemp -d 2>/dev/null || mktemp -d "${TMPDIR:-/tmp}/xerj.XXXXXX")
trap 'rm -rf "$tmp"' EXIT INT TERM
info "downloading ${asset}…"
DL "${base}/${asset}" "${tmp}/${asset}" \
|| die "download failed for ${target}. Available assets: https://github.com/${REPO}/releases/tag/${tag}"
-# --- verify checksum (best-effort; fail if the .sha256 is present) ----------
-if DL "${base}/${asset}.sha256" "${tmp}/${asset}.sha256" 2>/dev/null; then
- want=$(awk '{print $1}' "${tmp}/${asset}.sha256")
- if command -v sha256sum >/dev/null 2>&1; then got=$(sha256sum "${tmp}/${asset}" | awk '{print $1}')
- elif command -v shasum >/dev/null 2>&1; then got=$(shasum -a 256 "${tmp}/${asset}" | awk '{print $1}')
- else got=""; fi
- if [ -n "$got" ]; then
- [ "$got" = "$want" ] && ok "sha256 verified" || die "sha256 mismatch (want $want, got $got)"
- fi
+# --- verify checksum (fail closed — every release publishes the .sha256) ----
+DL "${base}/${asset}.sha256" "${tmp}/${asset}.sha256" 2>/dev/null \
+ || die "could not download checksum ${asset}.sha256 — refusing to install an unverified binary"
+want=$(awk '{print $1}' "${tmp}/${asset}.sha256")
+if command -v sha256sum >/dev/null 2>&1; then got=$(sha256sum "${tmp}/${asset}" | awk '{print $1}')
+elif command -v shasum >/dev/null 2>&1; then got=$(shasum -a 256 "${tmp}/${asset}" | awk '{print $1}')
+else got=""; fi
+if [ -n "$got" ]; then
+ [ "$got" = "$want" ] && ok "sha256 verified" || die "sha256 mismatch (want $want, got $got)"
+else
+ say "${YEL}warning:${RST} sha256sum/shasum not found — skipping checksum verification"
fi
# --- extract ----------------------------------------------------------------
info "extracting…"
if [ "$ext" = "zip" ]; then
- need unzip; unzip -q "${tmp}/${asset}" -d "$tmp"
+ # Git Bash / MSYS often lack `unzip` — fall back to the PowerShell that
+ # ships with every Windows box. Paths travel via environment variables
+ # (never interpolated into the PS command) and -LiteralPath, so spaces,
+ # apostrophes and [brackets] in %TEMP% can't break quoting or glob.
+ if command -v unzip >/dev/null 2>&1; then
+ unzip -q "${tmp}/${asset}" -d "$tmp"
+ elif command -v powershell.exe >/dev/null 2>&1; then
+ zip_w=$(cygpath -w "${tmp}/${asset}" 2>/dev/null || printf '%s' "${tmp}/${asset}")
+ dst_w=$(cygpath -w "$tmp" 2>/dev/null || printf '%s' "$tmp")
+ XERJ_ZIP="$zip_w" XERJ_DST="$dst_w" powershell.exe -NoProfile -NonInteractive -Command \
+ 'Expand-Archive -LiteralPath $env:XERJ_ZIP -DestinationPath $env:XERJ_DST -Force' \
+ || die "failed to extract ${asset} (install 'unzip', or use the native installer: powershell -ExecutionPolicy Bypass -c \"irm https://xerj.org/get.ps1 | iex\")"
+ else
+ die "need 'unzip' to extract ${asset} — or use the native installer: powershell -ExecutionPolicy Bypass -c \"irm https://xerj.org/get.ps1 | iex\""
+ fi
else
tar -xzf "${tmp}/${asset}" -C "$tmp"
fi
@@ -104,14 +128,28 @@ src="${tmp}/${stage}/${bin}"
chmod +x "$src" 2>/dev/null || true
# --- choose install dir -----------------------------------------------------
+# Re-testing -w AFTER the mkdir matters: mkdir -p on an EXISTING but
+# root-owned ~/.local/bin returns 0, and we must fall through to $(pwd)
+# instead of failing later at the copy.
if [ "${XERJ_INSTALL_DIR:-}" != "" ]; then dir="$XERJ_INSTALL_DIR"
-elif [ -w "${HOME:-/nonexistent}/.local/bin" ] || mkdir -p "${HOME:-/nonexistent}/.local/bin" 2>/dev/null; then dir="${HOME}/.local/bin"
+elif [ -n "${HOME:-}" ] \
+ && { [ -d "$HOME/.local/bin" ] || mkdir -p "$HOME/.local/bin" 2>/dev/null; } \
+ && [ -w "$HOME/.local/bin" ]; then dir="$HOME/.local/bin"
else dir="$(pwd)"; fi
mkdir -p "$dir" 2>/dev/null || die "cannot create install dir: $dir"
+# Stage inside the destination directory, then rename: same-directory mv is
+# an atomic rename(2), so $dest is always either the old or the new binary —
+# never a truncated copy (mv from tmpfs /tmp is a non-atomic cross-device
+# copy that Ctrl-C or ENOSPC could otherwise tear mid-write).
dest="${dir}/${bin}"
-mv "$src" "$dest" || die "failed to install to $dest"
-ok "installed ${BOLD}${dest}${RST}"
+tmpdest="${dir}/.${bin}.tmp.$$"
+if cp "$src" "$tmpdest" && mv -f "$tmpdest" "$dest"; then
+ ok "installed ${BOLD}${dest}${RST}"
+else
+ rm -f "$tmpdest"
+ die "failed to install to $dest"
+fi
# --- next steps -------------------------------------------------------------
say ""
diff --git a/landing/get.ps1 b/landing/get.ps1
new file mode 100644
index 000000000..e34c0db4c
--- /dev/null
+++ b/landing/get.ps1
@@ -0,0 +1,158 @@
+# =============================================================================
+# xerj installer for Windows
+# powershell -ExecutionPolicy Bypass -c "irm https://xerj.org/get.ps1 | iex"
+# =============================================================================
+# Detects your CPU (x64 / ARM64), downloads the matching release from
+# github.com/xerj-org/xerj/releases, verifies its SHA-256, and installs a
+# single xerj.exe. No JVM, no dependencies - one static binary.
+#
+# Environment overrides:
+# XERJ_VERSION=v1.0.0 install a specific tag (default: latest release)
+# XERJ_INSTALL_DIR=path install location (default: %LOCALAPPDATA%\Programs\xerj)
+# XERJ_REPO=owner/name source repo (default: xerj-org/xerj)
+# XERJ_NO_PATH=1 do not add the install dir to the user PATH
+#
+# Works on Windows PowerShell 5.1 and PowerShell 7+.
+#
+# The whole body runs inside an anonymous script block so that, when piped
+# into `iex` from an interactive session, our preference variables, helper
+# functions and locals do not leak into (or rewire) the caller's shell.
+# =============================================================================
+& {
+ $ErrorActionPreference = 'Stop'
+ # PS 5.1: the default progress bar slows Invoke-WebRequest downloads by
+ # 10-100x (redrawn per buffer read). Scoped to this block, so the caller's
+ # setting is untouched.
+ $ProgressPreference = 'SilentlyContinue'
+
+ function Write-Step($msg) { Write-Host "==> $msg" -ForegroundColor Yellow }
+ function Write-Okay($msg) { Write-Host " ok $msg" -ForegroundColor Green }
+ # throw, not exit: when the script is piped into `iex` from an interactive
+ # shell, `exit` would close the user's whole terminal session.
+ function Fail($msg) { Write-Host "error: $msg" -ForegroundColor Red; throw "xerj install failed" }
+
+ $Repo = if ($env:XERJ_REPO) { $env:XERJ_REPO } else { 'xerj-org/xerj' }
+
+ # TLS 1.2 for Windows PowerShell 5.1 (7+ already defaults to it).
+ try {
+ [Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12
+ } catch {}
+
+ # --- detect CPU ------------------------------------------------------------
+ # Machine scope reflects the real hardware even when this PowerShell runs
+ # under emulation (x64 PS7 on Windows-on-ARM reports AMD64 in process scope).
+ # PROCESSOR_ARCHITEW6432 covers 32-bit PowerShell on a 64-bit OS.
+ $rawArch = [Environment]::GetEnvironmentVariable('PROCESSOR_ARCHITECTURE', 'Machine')
+ if (-not $rawArch) {
+ $rawArch = if ($env:PROCESSOR_ARCHITEW6432) { $env:PROCESSOR_ARCHITEW6432 } else { $env:PROCESSOR_ARCHITECTURE }
+ }
+ switch ($rawArch) {
+ 'AMD64' { $cpu = 'x86_64' }
+ 'ARM64' { $cpu = 'aarch64' }
+ default { Fail "unsupported CPU '$rawArch' - xerj ships Windows builds for x64 (AMD64) and ARM64" }
+ }
+ $target = "$cpu-pc-windows-msvc"
+
+ # --- resolve version -------------------------------------------------------
+ if ($env:XERJ_VERSION) {
+ $tag = $env:XERJ_VERSION
+ if ($tag -notmatch '^v') { $tag = "v$tag" } # release tags are v-prefixed
+ } else {
+ Write-Step "resolving latest release of $Repo..."
+ try {
+ $rel = Invoke-RestMethod -UseBasicParsing -Uri "https://api.github.com/repos/$Repo/releases/latest"
+ $tag = $rel.tag_name
+ } catch {
+ Fail "could not resolve the latest release ($($_.Exception.Message)) - set `$env:XERJ_VERSION='vX.Y.Z' (see https://github.com/$Repo/releases)"
+ }
+ if (-not $tag) { Fail "could not resolve the latest release - set `$env:XERJ_VERSION='vX.Y.Z'" }
+ }
+ $ver = $tag.TrimStart('v')
+ $stage = "xerj-$ver-$target"
+ $asset = "$stage.zip"
+ $base = "https://github.com/$Repo/releases/download/$tag"
+ Write-Step "installing xerj $tag for $target"
+
+ # --- download ----------------------------------------------------------------
+ $tmp = Join-Path ([IO.Path]::GetTempPath()) ("xerj-install-" + [IO.Path]::GetRandomFileName())
+ New-Item -ItemType Directory -Force -Path $tmp | Out-Null
+ try {
+ Write-Step "downloading $asset..."
+ try {
+ Invoke-WebRequest -UseBasicParsing -Uri "$base/$asset" -OutFile (Join-Path $tmp $asset)
+ } catch {
+ Fail "download failed for $target ($($_.Exception.Message)). Available assets: https://github.com/$Repo/releases/tag/$tag"
+ }
+
+ # --- verify checksum (fail closed - every release publishes the .sha256) --
+ try {
+ Invoke-WebRequest -UseBasicParsing -Uri "$base/$asset.sha256" -OutFile (Join-Path $tmp "$asset.sha256")
+ } catch {
+ Fail "could not download checksum $asset.sha256 ($($_.Exception.Message)) - refusing to install an unverified binary"
+ }
+ $want = ((Get-Content (Join-Path $tmp "$asset.sha256") -Raw) -split '\s+')[0].ToLower()
+ $got = (Get-FileHash -Algorithm SHA256 (Join-Path $tmp $asset)).Hash.ToLower()
+ if ($got -ne $want) { Fail "sha256 mismatch (want $want, got $got)" }
+ Write-Okay "sha256 verified"
+
+ # --- extract ---------------------------------------------------------------
+ Write-Step "extracting..."
+ Expand-Archive -Path (Join-Path $tmp $asset) -DestinationPath $tmp -Force
+ $src = Join-Path (Join-Path $tmp $stage) 'xerj.exe'
+ if (-not (Test-Path $src)) {
+ $found = Get-ChildItem -Path $tmp -Recurse -Filter 'xerj.exe' | Select-Object -First 1
+ if ($found) { $src = $found.FullName } else { Fail "xerj.exe not found in archive" }
+ }
+
+ # --- install ---------------------------------------------------------------
+ $dir = if ($env:XERJ_INSTALL_DIR) { $env:XERJ_INSTALL_DIR } else { Join-Path $env:LOCALAPPDATA 'Programs\xerj' }
+ New-Item -ItemType Directory -Force -Path $dir | Out-Null
+ $dest = Join-Path $dir 'xerj.exe'
+ try {
+ Move-Item -Force -Path $src -Destination $dest
+ } catch {
+ Fail "could not replace $dest - if xerj is running, stop it first (Stop-Process -Name xerj) and re-run this installer"
+ }
+ Write-Okay "installed $dest"
+
+ # --- PATH (user scope, reversible; opt out with XERJ_NO_PATH=1) ------------
+ if (-not $env:XERJ_NO_PATH) {
+ $userPath = [Environment]::GetEnvironmentVariable('Path', 'User')
+ if (-not $userPath) { $userPath = '' }
+ $onPath = ($userPath -split ';' | Where-Object { $_ -eq $dir }).Count -gt 0
+ if (-not $onPath) {
+ $newPath = if ($userPath) { $userPath.TrimEnd(';') + ';' + $dir } else { $dir }
+ $wrote = $false
+ try {
+ # Preserve REG_EXPAND_SZ (%USERPROFILE% entries) - the plain
+ # SetEnvironmentVariable round-trip would expand and freeze them.
+ $k = [Microsoft.Win32.Registry]::CurrentUser.OpenSubKey('Environment', $true)
+ if ($k) {
+ $raw = $k.GetValue('Path', '', [Microsoft.Win32.RegistryValueOptions]::DoNotExpandEnvironmentNames)
+ $rawNew = if ($raw) { "$raw".TrimEnd(';') + ';' + $dir } else { $dir }
+ $k.SetValue('Path', $rawNew, [Microsoft.Win32.RegistryValueKind]::ExpandString)
+ $k.Close()
+ $wrote = $true
+ }
+ } catch {}
+ if (-not $wrote) { [Environment]::SetEnvironmentVariable('Path', $newPath, 'User') }
+ Write-Okay "added $dir to your user PATH (new terminals pick it up automatically)"
+ }
+ }
+ # Make `xerj` resolve in THIS session too, so the next-steps command works
+ # immediately (the registry write above only affects new terminals).
+ if (($env:Path -split ';') -notcontains $dir) {
+ $env:Path = $env:Path.TrimEnd(';') + ';' + $dir
+ }
+
+ # --- next steps --------------------------------------------------------------
+ Write-Host ""
+ Write-Host "xerj $tag is ready." -ForegroundColor White
+ Write-Host " start it: xerj --insecure --data-dir .\data"
+ Write-Host " then open the console: http://localhost:9200/_xerj-console/"
+ Write-Host " docs: https://xerj.org/docs/ - source: https://github.com/$Repo"
+ Write-Host ""
+ } finally {
+ Remove-Item -Recurse -Force -Path $tmp -ErrorAction SilentlyContinue
+ }
+}
diff --git a/landing/use-cases/ai-search-retrieval.html b/landing/use-cases/ai-search-retrieval.html
index c317d3086..ec2cb7e7e 100644
--- a/landing/use-cases/ai-search-retrieval.html
+++ b/landing/use-cases/ai-search-retrieval.html
@@ -26,7 +26,7 @@
<span class="spacer"></span>
<a href="/docs/index.html">DOCS</a>
<a href="/playground.html">DASHBOARDS</a>
- <a href="https://github.com/" rel="external">GITHUB</a>
+ <a href="https://github.com/xerj-org/xerj" rel="external">GITHUB</a>
<span class="theme">
<button type="button" data-theme="day">DAY</button>
<span class="dash">·</span>
diff --git a/landing/use-cases/elasticsearch-replacement.html b/landing/use-cases/elasticsearch-replacement.html
index 9b6ebb8f2..f7ec82bee 100644
--- a/landing/use-cases/elasticsearch-replacement.html
+++ b/landing/use-cases/elasticsearch-replacement.html
@@ -26,7 +26,7 @@
<span class="spacer"></span>
<a href="/docs/index.html">DOCS</a>
<a href="/playground.html">DASHBOARDS</a>
- <a href="https://github.com/" rel="external">GITHUB</a>
+ <a href="https://github.com/xerj-org/xerj" rel="external">GITHUB</a>
<span class="theme">
<button type="button" data-theme="day">DAY</button>
<span class="dash">·</span>
diff --git a/landing/use-cases/operational-intelligence.html b/landing/use-cases/operational-intelligence.html
index 28fb60677..8ef4ee10c 100644
--- a/landing/use-cases/operational-intelligence.html
+++ b/landing/use-cases/operational-intelligence.html
@@ -26,7 +26,7 @@
<span class="spacer"></span>
<a href="/docs/index.html">DOCS</a>
<a href="/playground.html">DASHBOARDS</a>
- <a href="https://github.com/" rel="external">GITHUB</a>
+ <a href="https://github.com/xerj-org/xerj" rel="external">GITHUB</a>
<span class="theme">
<button type="button" data-theme="day">DAY</button>
<span class="dash">·</span>
diff --git a/landing/use-cases/security-analytics.html b/landing/use-cases/security-analytics.html
index ddea1874c..b91054cd1 100644
--- a/landing/use-cases/security-analytics.html
+++ b/landing/use-cases/security-analytics.html
@@ -26,7 +26,7 @@
<span class="spacer"></span>
<a href="/docs/index.html">DOCS</a>
<a href="/playground.html">DASHBOARDS</a>
- <a href="https://github.com/" rel="external">GITHUB</a>
+ <a href="https://github.com/xerj-org/xerj" rel="external">GITHUB</a>
<span class="theme">
<button type="button" data-theme="day">DAY</button>
<span class="dash">·</span>
diff --git a/landing/use-cases/unified-observability.html b/landing/use-cases/unified-observability.html
index 48e66e481..e7d366f4f 100644
--- a/landing/use-cases/unified-observability.html
+++ b/landing/use-cases/unified-observability.html
@@ -26,7 +26,7 @@
<span class="spacer"></span>
<a href="/docs/index.html">DOCS</a>
<a href="/playground.html">DASHBOARDS</a>
- <a href="https://github.com/" rel="external">GITHUB</a>
+ <a href="https://github.com/xerj-org/xerj" rel="external">GITHUB</a>
<span class="theme">
<button type="button" data-theme="day">DAY</button>
<span class="dash">·</span>