HCloud - Hetzner Cloud Management GUI

Now with support to build a DigitalOcean server too!

If you use this, please report any issues to @Proph151Music.
The script will constantly get updated with improvements, based on user feedback.

Don't forget to tip the bartender!

DAG Wallet Address for sending tips:
DAG0Zyq8XPnDKRB3wZaFcFHjL4seCLSDtHbUcYq3

---

Welcome to HCloud, a user-friendly GUI tool for managing your Hetzner Cloud infrastructure. Whether you're creating servers, setting up firewalls, managing SSH keys, or installing nodectl, HCloud streamlines these tasks so you don’t have to be a tech expert.

Update

• The tool now has an option for building a cloud server on DigitalOcean as well!

Key Features

• Platform Selection: Choose which platform (Hetzner or DigitalOcean).
• Manage Servers: Easily create, view, and delete servers.
• Firewall Management: Quickly set up and edit firewall rules.
• SSH Key Management: Import or create SSH keys for secure access.
• Install nodectl: Install nodectl on your servers with minimal effort.
• Cross-platform Support: Runs on Windows, macOS, Ubuntu Desktop, and ChromeOS.

Table of Contents

• Installation

  • Windows
  • MacOS
  • Ubuntu Desktop
  • ChromeOS

• How to Use HCloud

  • Launch HCloud
  • Enter Your Platform API Key
  • Create Server Tab
  • Install nodectl Tab

• Import Server Settings Into Termius (Optional)

• Acknowledgments

---

Installation

Windows

Download and Extract the HCloud_launcher.zip file

1. Download the File:

   • Right-click here and select "Save As" to download the Cloudlauncher.zip file.
   • Save it to your desired location (e.g., C:\Users\YourUsername\Downloads).

2. Extract the File:

   • Right-click on the ZIP file and choose "Extract All..."
   • Select your extraction folder and click "Extract".

3. Run the File:

   • Open the extracted folder and double-click Cloudlauncher.bat to run it.

---

MacOS

1. Install Python from the website:

   • https://www.python.org/downloads/macos/

2. Open Terminal and run:

curl -L -O https://raw.githubusercontent.com/StardustCollective/HCloud/main/MacOS/CloudLauncher.sh && chmod +x CloudLauncher.sh && ./CloudLauncher.sh

---

Ubuntu Desktop

Open Terminal and run:

wget https://raw.githubusercontent.com/StardustCollective/HCloud/main/HCloud.py && python3 HCloud.py

---

ChromeOS

If Linux is enabled on your ChromeOS device, open the Linux terminal and run:

wget https://raw.githubusercontent.com/StardustCollective/HCloud/main/HCloud.py && python3 HCloud.py

---

How to Use HCloud

Launch HCloud

1. Launch CloudLauncher.bat (Windows) or CloudLauncher.sh (MacOS):

   • Do you want to set up a local environment for HCloud?

     

     Send Y for Yes. This will download Python and install all of the needed dependencies for HCloud. this is only needed the first time you use HCloud.

   • At the next step you will be asked how you want to Launch HCloud.

     

     If this is the first launch, you will need to send d for Download. In the future you can send D to download the latest version or L to launch the current version you have.

---

2. Enter Your Platform API Key

   • When prompted, paste your Platform Cloud API key.

   

   If you don’t have one, follow these steps: The steps show how to perform it on Hetzner.

   For DigitalOcean, follow the steps in the link given on the API Key Input window. Make sure the key you generate is given Full Access.

   ---

   Creating a Hetzner API Key:

   • Log in to Hetzner Console:
     Visit the Hetzner Cloud Console and sign in.

   • Navigate to API Settings:
     Click Security > API Tokens in the left-hand menu.

   • Generate a New API Key:

     • Click Generate API Token.

       

     • Enter a name (e.g., "HCloud GUI") and select Read/Write permissions.

     • Click Generate API token.

   • Copy Your API Key:

     

     Since the key is shown only once, copy it now and paste it into HCloud. For security purposes it is not recommended to save this API key anywhere. You can always create a new one later if you need one in the future.

     ---

3. Manage Your Cloud Resources:

   Create Server Tab

   

   Enter a Server Name (only letters, numbers or dashes. No spaces or special characters!), select a Location, choose the Server Specs and the Distribution OS.
   HCloud auto-fills firewall and SSH key names if you leave them blank.

   ---

• Click the Create Server button once you have entered all of the needed information.

  • Firewall Management:
    You’ll be prompted to add your Home IP for extra security. (This helps prevent unauthorized access.)

    If you choose Yes then HCloud will ask if you have additional IP addresses you would like to give access to this server. For instance a Mobile Data IP address or maybe a Work IP. You can find the correct IP's by making sure you browse to whatsmyip.org on a device connected to that network.

    

    ---

  • SSH Key Management:
    Import or create new SSH key pairs directly within HCloud.
    You’ll be asked to create a passphrase for any new ssh keys.

    

    Be sure to document any new passwords! HCloud does not save this information for you. It is your responsibility to remember any passwords you create.

    ---

  Once the server is created you will see the Success window pop up.

  

  If you get a message about "Resource not available" then you need to choose different specs or change the location and try again. This is usually an indication that the specs you selected are sold out at that location.

Install nodectl Tab

• Select Server:
  Your server details are auto-populated after server creation. But there are some details you will still need to input.

• Select Network: Choose what network you need to setup for. mainnet, integrationnet, testnet, dor-metagraph-mainnet, (other options will be added in the future).

• Node Username:
  Defaults to nodeadmin (change if needed, but make sure you document it).

• nodectl Version:
  Make sure you install the correct nodectl version (check your Discord chat for details).

• Additional Options:

  • Import P12 File (Optional): Import your P12 file if you are rebuilding a node.
  • Desktop Shortcuts: On Windows, you can choose to create SSH/SFTP shortcuts.
  • Export to PuTTY: (Windows Only) If you have PuTTY and WinSCP installed, HCloud can export server settings to PuTTY.

• Click the Install nodectl button once you have entered all of the needed information. It will take roughly 2 minutes for nodectl to complete the install. Once it is complete, you will get a Success Window with your nodeID and an option to view the new ssh_config file. You can also import this config file into Termius!

---

Import Server Settings Into Termius (Optional)

After you have successfully installed nodectl on your new cloud server, you can easily import the server settings into Termius.

• Open Termius on your Windows or MacOS

• Click the dropdown on New Host and select Import.

  

• Select option ssh_config (Windows) or SSH:> (MacOS).

  

• On Windows you will browse to your config file that was created by HCloud. It can be found next to the HCloud files inside of a folder named SERVERS.

• On MacOS you do not need to browse. You should see the details already available to submit.

  ---

Acknowledgments

This tool was created by @Proph151Music for the Constellation Network ecosystem.
If you find HCloud helpful, please consider sending a tip!

DAG Wallet Address:
DAG0Zyq8XPnDKRB3wZaFcFHjL4seCLSDtHbUcYq3

---

Enjoy managing your Hetzner Cloud Server with HCloud!