---
name: "dune-rpc"
section: "1"
platform: "linux"
package: "dune"
version: "3.24.2-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/dune-rpc"
---

# dune-rpc(1)

Dune's RPC mechanism. Experimental.

## NAME

dune-rpc - Dune's RPC mechanism. Experimental.

## SYNOPSIS

**dune rpc** *COMMAND* …

## DESCRIPTION

This is experimental. do not use

## COMMANDS

- **build** \[*OPTION*\]… \[*TARGET*\]…

  build a given target (requires dune to be running in passive watching mode)

- **flush-file-watcher** \[*OPTION*\]…

  Flush pending file watcher notifications in a running watch server.

- **ping** \[*OPTION*\]…

  Ping the build server running in the current directory. Passing the --wait flag allows the command to wait for a connection to the server.

- **status** \[*OPTION*\]…

  show active connections

## COMMON OPTIONS

These options are common to all commands.

- **--help**\[=*FMT*\] (default=**auto**)

  Show this help in format *FMT*. The value *FMT* must be one of **auto**, **pager**, **groff** or **plain**. With **auto**, the format is **pager** or **plain** whenever the **TERM** env var is **dumb** or undefined.

- **--version**

  Show version information.

## MORE HELP

Use \`**dune** *COMMAND* --help' for help on a single command.

## EXIT STATUS

**dune rpc** exits with:

- 0

  on success.

- 1

  if an error happened.

- 130

  if it was interrupted by a signal.

## BUGS

Check bug reports at https://github.com/ocaml/dune/issues

## SEE ALSO

[dune(1)](/dune/1.md)