simhaonline/proxmox-hetzner-autoconfigure

A dialog based script to help configure a Proxmox host node after first boot. It takes over where the Hetzner installimage finishes to configure things like networking, TLS certificates and storage.

Proxmox Hetzner Autoconfigure

Takes over where the Hetzner installimage left off

About This Project

This is a command line dialog based tool to help configure a freshly installed Proxmox host node on a Hetzner dedicated server.

The application will ask you a series of questions to ascertain how you'd like your server to be setup, and output a neat, well documented boostrap.sh script you can execute on your Proxmox host to configure things like Networking, Storage, and TLS.

Things this project will help configure and whether they are implemented yet:

• Setting up the Network
  • Routed topology where you have purchased an additional subnet
  • Routed topology where you have purchased separate IPs
  • Bridged topology where you have purchased an additional subnet
  • Bridged topology where you have purchased separate IPs
  • Single IP (port forwarding, SNI)
• TLS with LetsEncrypt / ACME
• Mounting a Hetzner Storage Box
• Setting up LMV-Thin
• DNS and DHCP (DNSMasq)
• Wireguard

Hopefully this script saves some people some time. I'll try and update it as I learn new and better ways to do things with Proxmox.

Getting Started

To install the binary locally follow these steps:

Prerequisites

Needs a dialog like program in your search path. This is available on most Linux operating systems through the native package managers and on MacOS through brew. Windows users might have more trouble, although running through WSL or a VM would work.

You also need Python 3.6 or above and pip, if they're not already installed.

For example, on Debian:

$ apt install dialog python3-pip

Installation

1. Install the package using the python3 version of pip.

$ pip3 install proxmox_hetzner_autoconfigure

Usage

$ proxmox_hetzner_autoconfigure

Then follow the instructions. The application does not need to be run as root and will not make any changes to your system. It also does not need to be run on your Proxmox host node. It's better to run it locally and not pollute your host node with unnecessary dependencies.

It will ask you a series of questions using the venerable dialog application to ascertain how you would like your Proxmox system setup, and then output a simple shell (Bash) script boostrap.sh that can be run on your Proxmox host node.

bootstrap.sh has no dependencies and can easily be added to source control to document your system setup and for disaster recovery scenarios.

Development Setup

• Requires a working installation of Python 3.6 or above, dialog and Poetry.
• Checkout the source code using git

$ git clone https://github.com/johnknott/proxmox-hetzner-autoconfigure.git

• From within the project directory, fetch the dependencies using poetry.

$ poetry install

• From within the project directory, run the application using poetry.

$ poetry run main

• From within the project directory, run the test-suite using poetry.

$ poetry run pytest

Roadmap

See the open issues for a list of proposed features (and known issues).

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.

Contact

John Knott - @johndknott - [email protected]

Project Link: https://github.com/johnknott/proxmox-hetzner-autoconfigure