Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
83 changes: 83 additions & 0 deletions content/tutorials/connect-remote-gui.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,83 @@
---
title: Connect GUI to Remote Node
weight: 8
---

Since Pactus version 1.12.0, users can connect to a remote node using the Pactus GUI.
This enables them to easily monitor their node on any VPS from their personal computer.
Managing your nodes, sending transactions, and monitoring validators can all be done through the GUI application.

In this document, we explain the ways you can connect to your node through the Pactus GUI.

## Bare Connection

To connect to your node, the [gRPC](https://grpc.io/docs/what-is-grpc/) service of your remote node must be enabled.
The gRPC connection is unencrypted by default, so the connection between the GUI and your node is bare and unencrypted.

Here is an example of how you can connect to your node:

{{< os_tabs items="unix,windows" >}}
{{< os_tab >}}

```shell
./pactus-gui -grpc-addr http://testnet1.pactus.org:50052 -grpc-insecure
```

{{< /os_tab >}}
{{< os_tab >}}

```shell
pactus-gui.exe -grpc-addr http://testnet1.pactus.org:50052 -grpc-insecure
```

{{< /os_tab >}}
{{< /os_tabs >}}

You can use an IP address for the connection, such as `157.180.70.236:50052`.
The `-grpc-insecure` flag indicates that the connection is not secure and not encrypted.
We do not recommend enabling the wallet service in this mode, as all credentials and
information you send or receive may be observed by a man-in-the-middle attacker.

## Secure Connection

One simple way to secure the gRPC connection is to wrap it over the `https` protocol.
This is known as [gRPC-Web](https://grpc.io/docs/platforms/web/).

You can follow the [Secure Connections](./secure-connections.md) tutorial to set up your server to
wrap the gRPC connection over the `https` protocol. We have explained how to secure the connection there.
This approach requires a domain name and NGINX installed on your server.

Once the gRPC-Web setup is complete, you can connect to your node in a secure and encrypted way, as shown below:

{{< os_tabs items="unix,windows" >}}
{{< os_tab >}}

```shell
./pactus-gui -grpc-addr https://testnet1.pactus.org/grpc-web
```

{{< /os_tab >}}
{{< os_tab >}}

```shell
pactus-gui.exe -grpc-addr https://testnet1.pactus.org/grpc-web
```

{{< /os_tab >}}
{{< /os_tabs >}}

In this case, your connection from your computer to your node is fully encrypted and secure against man-in-the-middle attacks.

## Enabling Wallet Service

By default, the wallet service on your node is disabled. You can enable it in the config file;
however, if your connection is insecure, we do not recommend it.
If you do enable it, make sure you set a strong password for your wallet.

## FAQ

### I got a `server: 403 (Forbidden)` error

If you set up your domain using Cloudflare, this is most likely because the Cloudflare gRPC service is disabled.
You can check their [documentation](https://developers.cloudflare.com/network/grpc-connections/#enable-grpc)
to enable the gRPC service.
2 changes: 1 addition & 1 deletion content/tutorials/integration-guide.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Pactus Integration Guide
weight: 13
weight: 14
---

## Preface
Expand Down
2 changes: 1 addition & 1 deletion content/tutorials/linux-systemd.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Run Pactus with systemd on Linux
weight: 10
weight: 11
---

## Preface
Expand Down
2 changes: 1 addition & 1 deletion content/tutorials/pactus-metrics.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Run Pactus Metrics
weight: 9
weight: 10
---

## Preface
Expand Down
2 changes: 1 addition & 1 deletion content/tutorials/pactus-testnet.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Join Pactus Testnet
weight: 14
weight: 15
---

## Preface
Expand Down
2 changes: 1 addition & 1 deletion content/tutorials/reduce-network.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Reduce Network Usage
weight: 8
weight: 9
---

## Preface
Expand Down
2 changes: 1 addition & 1 deletion content/tutorials/software-verification.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Verify Pactus Software Is Safe
weight: 11
weight: 12
---

## Preface
Expand Down
2 changes: 1 addition & 1 deletion content/tutorials/zero-fee-transactions.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Send Zero-Fee Transactions
weight: 12
weight: 13
---

## Preface
Expand Down
Loading