# Setup LiquidOps on Voltage nodes (agent based - push)

In order to fully leverage the capabilities of LiquidOps with a Voltage node, it is essential to utilize our open source [agent](https://github.com/bolt-observer/agent). Since Voltage does not support direct installation of bolt.observer, the recommended approach is to install the agent on a separate server, which can seamlessly operate alongside a Voltage node.

### Recommended setup

In this tutorial, we will explain how to configure our open-source agent to work with a Voltage node. Refer to the chart below for a visual representation:

<figure><img src="/files/tzONZd1gonlTuNjjoiv9" alt=""><figcaption><p>Agent and Lightning node running on separate machines </p></figcaption></figure>

Machine 1: Voltage node

Machine 2: a secondary server  where the agent can be installed&#x20;

For the agent installation, you can find more information in [Agent based - push](/readme/liquidops/setup-liquidops/agent-based-push.md) and in the [repository](https://github.com/bolt-observer/agent#install).

### Voltage setup

LiquidOps provides extensive automation capabilities for a wide array of operations, including connectivity, node status notifications, and liquidity management through [auto swaps](/readme/liquidops/node-and-liquidity-automation.md). Liquidity management specifically requires on-chain and off-chain permissions, as well as access to addresses, invoices, and read/write permissions.

<figure><img src="/files/13xIU8VzgRzsZPOIdWMZ" alt=""><figcaption></figcaption></figure>

After logging into your Voltage account, navigate your "**home**" page. Scroll down the page and download the **Admin macaroon** and the **TLS certificate** onto the machine where you plan to install the agent. In this case, it would be Machine 2, as mentioned in the previous instructions[#agent-setup](#agent-setup "mention").

### Agent installation

Install the agent by following the instructions under github [repository](https://github.com/bolt-observer/agent#install).

### Agent options

Ensure the following options are properly configured in the agent:&#x20;

#### Apikey

Log into your account on bolt.observer, and from your node page and click on "**Enroll in LiquidOps**"

<figure><img src="/files/CCQRgm9ila9UlM3EdhcA" alt=""><figcaption><p>LiquidOps setup with agent</p></figcaption></figure>

Generate an API key and copy its value.&#x20;

<figure><img src="/files/z7Oz6oSGX8ZrivyUG49M" alt=""><figcaption></figcaption></figure>

Add the API key as an option in your command line:

<figure><img src="/files/Bgcm9fN3WqHyw7Rhr9DA" alt=""><figcaption></figcaption></figure>

<pre><code><strong>--apikey a3fxxxxxxxxxxxxxxxxxxxxxxxxxx
</strong></code></pre>

#### Macaroon path

Specify the path to the admin macaroon file using the following option:

<pre><code><strong>--macaroonpath /some/path/to/file.macaroon
</strong></code></pre>

#### TLS Certificate path

Specify the path to the TLS certificate file using the following option:

```
--tlscertpath /some/path/to/tls.cert
```

#### RPC server

Set the RPC server address using the following option:

```
--rpcserver demo.m.voltageapp.io:10009
```

The complete command line with all options is shown below:

{% code overflow="wrap" %}

```
bolt-agent --apikey a3fxxxxxxxxxxx --macaroonpath /some/path/to/file.macaroon --tlscertpath /some/path/to/tls.cert --rpcserver demo.m.voltageapp.io:10009
```

{% endcode %}

<figure><img src="/files/EmyfMBJ0crhXn7cYy2tU" alt=""><figcaption><p>Command line agent configuration</p></figcaption></figure>

For additional options&#x20;

### Verification

Once the bolt-agent is running correctly, refresh your node page, and you should see "LiquidOps enabled" and the data source displayed in the top right corner of the page.

<figure><img src="/files/TRqQhlpv9fXbBPpN1Svp" alt=""><figcaption></figcaption></figure>

From this point, you can [Create a workflow with auto swaps](/readme/guides/create-a-workflow-with-auto-swaps.md) and starts enjoying the benefits of LiquidOps.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bolt.observer/readme/guides/setup-liquidops-on-voltage-nodes-agent-based-push.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
