---
title: "remote setup"
description: "Store credentials for an existing machine-memory Worker."
---

> Documentation Index
> Fetch the complete documentation index at: https://machine-memory.jfa.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# remote setup

## Usage

```sh
machine-memory remote setup
```

`remote setup` connects the CLI to an already deployed authenticated Worker created by the [`remote provision` command](/human/remote/provision).

If flags are omitted, the command prompts for the missing values. Existing credentials are used as defaults when available. The interactive Worker token prompt masks each entered character.

## Options

| Option                   | Description                                                  |
| ------------------------ | ------------------------------------------------------------ |
| `--url <worker-url>`     | Existing Worker URL. `http://` and `https://` are accepted.  |
| `--token <worker-token>` | Token accepted by the Worker’s authenticated query endpoint. |

After setup, database-backed commands can use `--remote`:

```sh
machine-memory list --remote
```

Source: https://machine-memory.jfa.dev/human/remote/setup/index.mdx