docs/daprdocs/content/en/reference/components-reference/supported-state-stores/setup-rethinkdb.md

type	title	linkTitle	description	aliases
docs	RethinkDB	RethinkDB	Detailed information on the RethinkDB state store component	/operations/components/setup-state-store/supported-state-stores/setup-rethinkdb/

Component format

To setup RethinkDB state store, create a component of type state.rethinkdb. See [the how-to guide]({{< ref "howto-get-save-state.md#step-1-setup-a-state-store" >}}) to create and apply a state store configuration.

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
  name: <NAME>
spec:
  type: state.rethinkdb
  version: v1
  metadata:
  - name: address
    value: <REPLACE-RETHINKDB-ADDRESS> # Required, e.g. 127.0.0.1:28015 or rethinkdb.default.svc.cluster.local:28015).
  - name: database
    value: <REPLACE-RETHINKDB-DB-NAME> # Required, e.g. dapr (alpha-numerics only)
  - name: table
    value: # Optional
  - name: username
    value: <USERNAME> # Optional
  - name: password
    value: <PASSWORD> # Optional
  - name: archive
    value: bool # Optional (whether or not store should keep archive table of all the state changes)

{{% alert title="Warning" color="warning" %}} The above example uses secrets as plain strings. It is recommended to use a secret store for the secrets, as described [here]({{< ref component-secrets.md >}}). {{% /alert %}}

If the optional archive metadata is set to true, on each state change, the RethinkDB state store will also log state changes with timestamp in the daprstate_archive table. This allows for time series analyses of the state managed by Dapr.

Spec metadata fields

Field	Required	Details	Example
address	Y	The address for RethinkDB server	"127.0.0.1:28015", "rethinkdb.default.svc.cluster.local:28015"
database	Y	The database to use. Alpha-numerics only	"dapr"
table	N	The table name to use	"table"
username	N	The username to connect with	"user"
password	N	The password to connect with	"password"
archive	N	Whether or not to archive the table	"true", "false"

Setup RethinkDB

{{< tabs "Self-Hosted" >}}

{{% codetab %}} You can run RethinkDB locally using Docker:

docker run --name rethinkdb -v "$PWD:/rethinkdb-data" -d rethinkdb:latest

To connect to the admin UI:

open "http://$(docker inspect --format '{{ .NetworkSettings.IPAddress }}' rethinkdb):8080"

{{% /codetab %}} {{% /codetab %}}

Related links

• [Basic schema for a Dapr component]({{< ref component-schema >}})
• Read [the how-to guide]({{< ref "howto-get-save-state.md#step-2-save-and-retrieve-a-single-state" >}}) for instructions on configuring state store components.
• [State management building block]({{< ref state-management >}}).