Package: proxmox-hetzner-autoconfigure
Proxmox Hetzner AutoconfigureTakes over where the Hetzner installimage left offAbout This ProjectThis is a command linedialogbased tool to help configure a freshly installed Proxmox host node on a Hetzner dedicated server.If you haven't yet installed Proxmox on your Hetzner server, start here:Installing Proxmox on Hetzner, then use this tool
to help configure the rest.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 documentedboostrap.shscript 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 NetworkRouted topology where you have purchased an additional subnetRouted topology where you have purchased separate IPsBridged topology where you have purchased an additional subnetBridged topology where you have purchased separate IPsSingle IP (port forwarding, SNI)TLS with LetsEncrypt / ACMEMounting a Hetzner Storage BoxSetting up LMV-ThinDNS and DHCP (DNSMasq)WireguardScheduled BackupsHopefully 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 StartedTo install the binary locally follow these steps:PrerequisitesNeeds adialoglike program in your search path.
This is available on most Linux operating systems through the native package managers and on MacOS throughbrew.
Windows users might have more trouble, although running through WSL or a VM would work.You also needPython 3.6 or aboveand pip, if they're not already installed.For example, on Debian:$aptinstalldialogpython3-pipInstallationInstall the package using the python3 version of pip.$pip3installproxmox_hetzner_autoconfigureUsage$proxmox_hetzner_autoconfigureThen 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 venerabledialogapplication to ascertain how you would like your Proxmox system setup, and then output a simple shell (Bash) scriptboostrap.shthat can be run on your Proxmox host node.bootstrap.shhas no dependencies and can easily be added to source control to document your system setup and for disaster recovery scenarios.Development SetupRequires a working installation ofPython 3.6 or above,dialogandPoetry.Checkout the source code usinggit$gitclonehttps://github.com/johnknott/proxmox-hetzner-autoconfigure.gitFrom within the project directory, fetch the dependencies usingpoetry.$poetryinstallFrom within the project directory, run the application usingpoetry.$poetryrunproxmox-hetzner-autoconfigureFrom within the project directory, run the test-suite usingpoetry.$poetryrunpytestRoadmapSee theopen issuesfor a list of proposed features (and known issues).ContributingContributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make aregreatly appreciated.Fork the ProjectCreate your Feature Branch (git checkout -b feature/AmazingFeature)Commit your Changes (git commit -m 'Add some AmazingFeature')Push to the Branch (git push origin feature/AmazingFeature)Open a Pull RequestLicenseDistributed under the MIT License. SeeLICENSEfor more information.ContactJohn Knott -@johndknott-john.knott@gmail.comProject Link:https://github.com/johnknott/proxmox-hetzner-autoconfigure