Skip to content

docs: note standalone Nexus sample public preview #241

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
litlep-nibbyt merged 9 commits into from
Nov 2, 2026
Merged

docs: note standalone Nexus sample public preview #241

Changes from all commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
057f7fe
docs: note standalone Nexus sample public preview
litlep-nibbyt Oct 14, 2026
38d7039
docs: update SANO local dev server setup
litlep-nibbyt Oct 14, 2026
52a0f1b
docs: announce SANO public preview
litlep-nibbyt Oct 14, 2026
b9293b9
docs: move SANO preview notice to top
litlep-nibbyt Oct 14, 2026
208fa64
docs: group SANO setup requirements
litlep-nibbyt Oct 14, 2026
e3a39c3
docs: rely on SANO-enabled dev server
litlep-nibbyt Oct 15, 2026
82b185e
docs: fix Temporal CLI endpoint command
litlep-nibbyt Oct 16, 2026
0239a5b
docs: document SANO server requirements
litlep-nibbyt Oct 30, 2026
e9af48f
docs: remove self-hosted SANO setup from sample
litlep-nibbyt Oct 31, 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
19 changes: 11 additions & 8 deletions src/NexusStandaloneOperations/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
# Nexus Standalone Operations

> [!NOTE]
> ✨ **Standalone Nexus Operations are now in [Public Preview](https://docs.temporal.io/evaluate/development-production-features/release-stages#public-preview).**
> We aim to preserve backward compatibility and avoid breaking changes.

This sample demonstrates how to use Standalone Nexus Operations (executing Nexus operations directly
from client code without wrapping them in a Workflow). It shows both sync and async
(workflow-backed) operations, and how to use the `ListNexusOperationsAsync` and
Expand All @@ -11,25 +15,24 @@ configured via the SDK's [environment configuration](https://docs.temporal.io/de
support (`ClientEnvConfig.LoadClientConnectOptions()`), which reads `TEMPORAL_NAMESPACE`,
`TEMPORAL_ADDRESS`, etc. from the environment (and optionally profiles from `temporal.toml`).

> [!NOTE]
> Standalone Nexus operations require a server version that supports this feature. Use the dev
> server build at:
> https://github.com/temporalio/cli/releases/tag/v1.7.4-standalone-nexus-operations.

## Run locally against a dev server

1. Start the [Temporal dev server build that supports standalone Nexus operations](https://docs.temporal.io/standalone-nexus-operation#temporal-cli-support) with the required namespaces pre-created:
> [!NOTE]
> Standalone Nexus Operations require a server that supports this feature. For local development, use Temporal CLI v1.9.1 or later and enable SANO as shown below.

1. Start a [Temporal dev server](https://docs.temporal.io/cli/setup-cli) with the required namespaces pre-created:

```bash
./temporal server start-dev \
temporal server start-dev \
--dynamic-config-value "nexusoperation.enableStandalone=true" \
--namespace my-caller-namespace \
--namespace my-handler-namespace
```

2. Create a Nexus endpoint that routes to the handler namespace and the worker's task queue:

```bash
./temporal operator nexus endpoint create \
temporal operator nexus endpoint create \
--name my-nexus-endpoint \
--target-namespace my-handler-namespace \
--target-task-queue nexus-handler-queue
Expand Down
Loading