Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
18 commits
Select commit Hold shift + click to select a range
9cc7bec
Improve local dev instructions and formatting in readme
May 31, 2026
3c0c4c0
Clarify build-from-source prerequisite descriptions
agentofreality May 31, 2026
f3371bd
Remove stray placeholder file accidentally committed in #205
agentofreality May 31, 2026
f2dc541
Revert hugo server flags that break Docsy's SCSS pipeline
agentofreality May 31, 2026
bf5abcf
docs(drasi-server): update build-from-source for v0.2.0
agentofreality May 31, 2026
5c24e49
docs(getting-started): simplify Step 3 with pre-prepared config file
agentofreality May 31, 2026
9e86a06
docs(getting-started): hide setup variants from sidebar and polish St…
agentofreality May 31, 2026
ba53db7
docs(getting-started): open tutorial with a problem-first hook
agentofreality May 31, 2026
ffcdfd2
docs(drasi-context): add developer value-framing guidance
agentofreality May 31, 2026
33958bc
docs(getting-started): tighten tutorial flow and setup pages
agentofreality Jun 1, 2026
571ee72
docs(getting-started): emphasize the configuration-over-code contrast
agentofreality Jun 1, 2026
1ab8531
Potential fix for pull request finding
agentofreality Jun 1, 2026
079e95b
Potential fix for pull request finding
agentofreality Jun 1, 2026
2aaa213
Potential fix for pull request finding
agentofreality Jun 1, 2026
bb9cc4e
Potential fix for pull request finding
agentofreality Jun 1, 2026
c142921
Potential fix for pull request finding
agentofreality Jun 1, 2026
979a044
docs(configuration): fix double question mark in wizard prompt table
agentofreality Jun 1, 2026
12c32cc
docs(configuration): fix wizard wording and update spell-check dictio…
agentofreality Jun 1, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions .github/config/en-custom.txt
Original file line number Diff line number Diff line change
Expand Up @@ -1642,3 +1642,5 @@ Shopify
ns
Handlebars
Stripe
cp
cron
1 change: 0 additions & 1 deletion <path to affected file(s)>

This file was deleted.

509 changes: 259 additions & 250 deletions docs/content/drasi-server/getting-started/_index.md

Large diffs are not rendered by default.

Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,7 @@ type: "docs"
title: "Setup: Build from Source"
linkTitle: "Build from Source"
weight: 40
toc_hide: true
description: "Build Drasi Server from source code"
---

Expand All @@ -12,15 +13,15 @@ Building from source is the most complex approach for getting Drasi Server so yo

- **Git** — Needed to clone the Drasi Server code
- **Docker** and **Docker Compose** — Needed to run the PostgreSQL database used in the tutorial
- **Rust 1.88+** — For building Drasi Server
- **Rust 1.88+** — Needed to build Drasi Server
- **Text Editor** — Needed to edit files during the tutorial
- **curl** — Used in later tutorial steps
- **curl** — Used to interact with Drasi Server's REST API during the tutorial

If you are not sure you have these prerequisites installed, or need help installing them, see the [troubleshooting section](#troubleshooting) at the end of this page for guidance.

## Step 1: Setup Native Build Dependencies

Building `drasi-server` requires several native C libraries. Install the dependencies for your platform:
Building Drasi Server requires several native C libraries. Install the dependencies for your platform:

### macOS

Expand Down Expand Up @@ -160,7 +161,9 @@ Verify the `drasi-server` binary works:
You should see output showing the version number, for example:

```text
drasi-server 0.1.0
drasi-server 0.2.0
rustc: rustc 1.88.0 (6b00bc388 2025-06-23)
plugin-sdk: 0.8.4
```

## Step 4: Build the SSE CLI
Expand All @@ -187,19 +190,11 @@ You should see output showing the version number, for example:
drasi-sse-cli 0.1.0
```

## Step 5: Create Docker network

Create a Docker network so that Drasi Server and the tutorial database container can communicate with each other:

```bash
docker network create drasi-network
```

## ✅ Setup Complete

You now have Drasi Server accessible at `./bin/drasi-server` from the repository root.

<p><a href="../#database" class="btn btn-success btn-lg">Continue with the Tutorial <i class="fas fa-arrow-right ms-2"></i></a></p>
<p><a href="../#setup" class="btn btn-success btn-lg">Continue with the Tutorial <i class="fas fa-arrow-right ms-2"></i></a></p>

## Troubleshooting

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,7 @@ type: "docs"
title: "Setup: Dev Container"
linkTitle: "Dev Container"
weight: 20
toc_hide: true
description: "Run Drasi Server in a VS Code Dev Container"
---

Expand Down Expand Up @@ -65,7 +66,7 @@ Verify that Drasi Server is accessible by running the following command in the t
You should see output showing the version number, for example:

```text
drasi-server 0.1.0
drasi-server 0.2.0
```

If you see a "file not found" error, the build may not have completed. Check the terminal output for errors and try rebuilding the container.
Expand All @@ -74,7 +75,7 @@ If you see a "file not found" error, the build may not have completed. Check the

You now have Drasi Server accessible at `./bin/drasi-server` from the repository root.

<p><a href="../#database" class="btn btn-success btn-lg">Continue with the Tutorial <i class="fas fa-arrow-right ms-2"></i></a></p>
<p><a href="../#setup" class="btn btn-success btn-lg">Continue with the Tutorial <i class="fas fa-arrow-right ms-2"></i></a></p>

## Troubleshooting

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,7 @@ type: "docs"
title: "Setup: Download Binary"
linkTitle: "Download Binary"
weight: 5
toc_hide: true
description: "Download a prebuilt Drasi Server binary for your platform"
---

Expand Down Expand Up @@ -60,19 +61,11 @@ To download the correct binaries for your platform run the following command:
{{< /tab >}}
{{< /tabpane >}}

## Step 4: Create Docker network

Create a Docker network so that Drasi Server and the tutorial database container can communicate with each other:

```bash
docker network create drasi-network
```

## ✅ Setup Complete

You now have Drasi Server accessible at `./bin/drasi-server` from the repository root.

<p><a href="../#database" class="btn btn-success btn-lg">Continue with the Tutorial <i class="fas fa-arrow-right ms-2"></i></a></p>
<p><a href="../#setup" class="btn btn-success btn-lg">Continue with the Tutorial <i class="fas fa-arrow-right ms-2"></i></a></p>

## Troubleshooting

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,7 @@ type: "docs"
title: "Setup: GitHub Codespace"
linkTitle: "GitHub Codespace"
weight: 10
toc_hide: true
description: "Run Drasi Server in a cloud-based GitHub Codespace"
---

Expand Down Expand Up @@ -57,14 +58,14 @@ Verify that Drasi Server is accessible:
You should see output showing the version number, for example:

```text
drasi-server 0.1.0
drasi-server 0.2.0
```

## ✅ Setup Complete

You now have Drasi Server accessible at `./bin/drasi-server` from the repository root.

<p><a href="../#database" class="btn btn-success btn-lg">Continue with the Tutorial <i class="fas fa-arrow-right ms-2"></i></a></p>
<p><a href="../#setup" class="btn btn-success btn-lg">Continue with the Tutorial <i class="fas fa-arrow-right ms-2"></i></a></p>

## Codespace Tips

Expand Down
11 changes: 11 additions & 0 deletions docs/content/drasi-server/how-to-guides/configuration/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,17 @@ description: "Step-by-step instructions for configuring Drasi Server"
---

<div class="card-grid">
<!--
<a href="create-config-with-wizard/">
<div class="unified-card unified-card--howto">
<div class="unified-card-icon"><i class="fas fa-magic"></i></div>
<div class="unified-card-content">
<h3 class="unified-card-title">Create Configuration with the Wizard</h3>
<p class="unified-card-summary">Scaffold a config file interactively with <code>drasi-server init</code></p>
</div>
</div>
</a>
-->
<a href="configure-drasi-server/">
<div class="unified-card unified-card--howto">
<div class="unified-card-icon"><i class="fas fa-file-alt"></i></div>
Expand Down
Loading
Loading