|
|
|
|
@@ -56,7 +56,7 @@ Only the sidecar is exposed, and only to your website.
|
|
|
|
|
| Administrator / root | It writes into system directories and registers a service. |
|
|
|
|
|
| Outbound HTTPS | To `gitea.whitlocktech.com`, to fetch the bundle and the two artifacts. Nothing inbound is needed, and no Gitea account or git client is required. |
|
|
|
|
|
| The sidecar on the **same host** as the shard | The shard connects to `127.0.0.1:7788`. Splitting them is not supported — the loopback socket *is* the trust boundary for inbound commands. |
|
|
|
|
|
| Admin access to your Runic Gateway site | The last step is pasting four values into Admin → Shard. |
|
|
|
|
|
| Admin access to your Runic Gateway site | The last step is pasting four values into Admin → Shard (uo-link). |
|
|
|
|
|
|
|
|
|
|
**Back up first.** The overlay overwrites `Scripts/Scripts.csproj` (a stock file), and the patch
|
|
|
|
|
tier edits stock sources. A copy of `Scripts/` and `Config/` before you start costs nothing.
|
|
|
|
|
@@ -150,7 +150,7 @@ one file); `doctor`, `update` and `uninstall` are run from it later. Examples be
|
|
|
|
|
3. **The hostname your website should use to reach this machine** — used only to compose the two
|
|
|
|
|
URLs it prints at the end. The sidecar's bind address is frequently `127.0.0.1` or `0.0.0.0`,
|
|
|
|
|
neither of which is something to hand to a website.
|
|
|
|
|
4. **Your site's URL** — used only to print a clickable link to its Admin → Shard page. The
|
|
|
|
|
4. **Your site's URL** — used only to print a clickable link to its Admin → Shard (uo-link) page. The
|
|
|
|
|
installer never contacts your website.
|
|
|
|
|
|
|
|
|
|
### An illustrative run
|
|
|
|
|
@@ -413,8 +413,8 @@ One manual step remains — connect the website to this sidecar:
|
|
|
|
|
Protocol version 4
|
|
|
|
|
Auth token 4f9c… (also in /etc/runicgateway/sidecar.toml)
|
|
|
|
|
|
|
|
|
|
Paste these into Admin → Shard on your Runic Gateway site:
|
|
|
|
|
https://your-site.example/admin/shard
|
|
|
|
|
Paste these into Admin → Shard (uo-link) on your Runic Gateway site:
|
|
|
|
|
https://your-site.example/admin/uo/link
|
|
|
|
|
|
|
|
|
|
The token is write-only once saved — the site will never show it back to you.
|
|
|
|
|
```
|
|
|
|
|
@@ -422,7 +422,14 @@ The token is write-only once saved — the site will never show it back to you.
|
|
|
|
|
Every value there comes from asking the installed sidecar itself (`--print-config`), not from a
|
|
|
|
|
log file or a guess, so it cannot drift from what the service actually runs.
|
|
|
|
|
|
|
|
|
|
On your site, sign in as an administrator and open **Admin → Shard (uo-link)**:
|
|
|
|
|
On your site, sign in as an administrator and open **Admin → Shard (uo-link)** — `/admin/uo/link`.
|
|
|
|
|
|
|
|
|
|
> **Installer v0.1.0 prints `/admin/shard`.** Those screens belong to the `uo` module
|
|
|
|
|
> now, and a module owns one path segment wherever it appears, so the page moved. The old path
|
|
|
|
|
> does not 404 — the site sends you to the dashboard, which looks like the link worked. If your
|
|
|
|
|
> run printed the old path, use the sidebar. (API routes are unaffected and keep
|
|
|
|
|
> `/api/v1/admin/shard/*`.)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| Field on the page | Paste |
|
|
|
|
|
|---|---|
|
|
|
|
|
|