Dan HeathandTodd
2005593dc2
* docs: Add client cache documentation * docs: Update command documentation * docs: Add management section * docs: Update commands and examples * docs: Fix code examples * docs: Fix typo * Apply batch of suggestions from code review Co-authored-by: Todd <github@quaddi.com> * docs: Updates from review, rewrite add-token * Apply batch of suggestions from code review Co-authored-by: Todd <github@quaddi.com> * docs: Update commands, add-token * docs: Change keyring name * Update website/content/docs/api-clients/client-cache.mdx Co-authored-by: Todd <github@quaddi.com> * docs: Update commands * Update website/content/docs/commands/search/index.mdx Co-authored-by: Todd <github@quaddi.com> --------- Co-authored-by: Todd <github@quaddi.com>
49 lines
1.8 KiB
Plaintext
49 lines
1.8 KiB
Plaintext
---
|
|
layout: docs
|
|
page_title: daemon start - Command
|
|
description: |-
|
|
The "daemon start" command lets you manually start the Boundary daemon and customize the behavior of the local cache.
|
|
---
|
|
|
|
# daemon start
|
|
|
|
Command: `boundary daemon start`
|
|
|
|
The `boundary daemon start` command lets you manually start the Boundary daemon and customize the behavior of the local cache.
|
|
|
|
## Example
|
|
|
|
The following command starts the Boundary daemon in the background:
|
|
|
|
```shell-session
|
|
$ boundary daemon start -background
|
|
```
|
|
|
|
## Usage
|
|
|
|
<CodeBlockConfig hideClipboard>
|
|
|
|
```shell-session
|
|
$ boundary daemon start [options] [args]
|
|
```
|
|
|
|
</CodeBlockConfig>
|
|
|
|
### Command options
|
|
|
|
- `background` - Starts the Boundary daemon in the background.
|
|
The default value is `false`.
|
|
By default, the daemon starts in the foreground.
|
|
- `log-format=<string>` - Specifies the log format, mostly as a fallback for events.
|
|
Supported values are `standard` and `json`.
|
|
- `max-search-refresh-timeout=<duration>` - If a search request triggers a best effort refresh, this value specifies how long the refresh should run before time out.
|
|
In the event of a timeout, Boundary uses the stale data that is currently in the cache.
|
|
The default value is 7 seconds.
|
|
- `max-search-staleness=<duration>` - The amount of time that can pass since the last refresh before the client cache causes a blocking refresh.
|
|
The blocking refresh occurs when you perform the `boundary search` command.
|
|
It requires Boundary to refresh the local cache using the control plane.
|
|
The default value is 30 seconds.
|
|
- `refresh-interval` - A duration that specifies how frequently the client cache should query Boundary for changes to sessions and targets.
|
|
Note that Boundary only searches sessions and targets that the user who ran the command has access to.
|
|
|
|
@include 'cmd-option-note.mdx' |