Getting Started with Proxmox VE and Twingate

Overview

This guide explains how to set up Twingate to securely access your Proxmox VE environment using the open source Proxmox VE Helper Scripts repository. By integrating Twingate with Proxmox VE, you can ensure that your private resources remain protected while enabling seamless remote access.

Prerequisites

Before you begin, ensure you have the following:

• A running instance of Proxmox VE.
• A Twingate account with access to the Admin Console.
• Basic familiarity with Proxmox VE’s configuration options.
• SSH access or web UI access to your Proxmox VE server.

Installation Steps

1. Generate Connector Access and Refresh Tokens

Start by generating new Access and Refresh tokens for a Connector. Follow these steps:

• Log in to the Twingate Admin Console.

  

• Navigate to Remote Networks.

  

• Select the Remote Network you want to add a Connector to.

  

• Add a Connector or select one that hasn’t been deployed yet.
• Select the Manual option.

  

• Scroll down to Step 2 and click Generate Tokens.

  

• Authenticate when prompted to complete token generation.
• Copy the Access Token and Refresh Token displayed. These will be used in the next step.

2. Deploy the Connector using the Community Helper Script

Run the following command on the head node of your Proxmox VE server:

bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/twingate-connector.sh)"

Eventually the script will prompt you to enter the following information:

• Network: Your Twingate Remote Network name (e.g., network.twingate.com).
• Access Token: Paste the Access Token generated in the Admin Console.
• Refresh Token: Paste the Refresh Token generated in the Admin Console.

After entering the required information, the script will automatically start the Twingate Connector on your Proxmox VE server.

3. Verify Installation

• Navigate back to the Admin Console.
• Navigate to Remote Networks.
• Select the Remote Network you added your new Connector to.
• Select the new Connector.
• Verify that the Controller and Relay statuses are connected.

  

Troubleshooting

Common Issues

• Token Errors: Ensure the Access and Refresh tokens are correctly entered.
• Connectivity Problems: Verify that you can access the Proxmox VE web interface locally and the Twingate Connector LXC is running.

If issues persist, take a look at the troubleshooting docs

Next Steps

Once Twingate is configured, you can explore additional resources to enhance your setup:

• Setting Up Resources: Learn how to configure Twingate Resources to gain access to private applications and services.