Skip to content

feat: document the new --unix-socket flag for HTTP builtins #2059

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

Open
wants to merge 2 commits into
base: main
Choose a base branch
from
+16 −0
Open

feat: document the new --unix-socket flag for HTTP builtins #2059

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
8bf7a6d
.
cablehead Oct 20, 2025
510a67e
.
cablehead Oct 21, 2025
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
16 changes: 16 additions & 0 deletions cookbook/http.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -292,3 +292,19 @@ Available metadata:
- `status` - HTTP status code (200, 404, 500, etc.)
- `headers` - `[{name, value}, ...]`
- `urls` - Redirect history

---

### Connecting via Unix Domain Sockets

You can connect to HTTP servers over Unix domain sockets using the `--unix-socket` flag. This works on Unix/Linux systems and Windows 10+ (build 17063 and later). This is commonly used for local services like the Docker daemon, systemd, or other IPC services.

```nu
# Query Docker daemon via Unix socket
http get --unix-socket /var/run/docker.sock http://localhost/containers/json

# The hostname in the URL populates the HTTP Host header
http post --unix-socket ./my-service.sock http://api/endpoint {data: "value"}
```

The socket path specifies where to connect, while the URL's hostname is used for the HTTP Host header.