Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/johnknott/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.
https://github.com/johnknott/proxmox-hetzner-autoconfigure
Last synced: about 2 months ago
JSON representation
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.
- Host: GitHub
- URL: https://github.com/johnknott/proxmox-hetzner-autoconfigure
- Owner: johnknott
- Created: 2020-07-15T14:06:44.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2021-03-17T20:28:11.000Z (over 3 years ago)
- Last Synced: 2024-07-16T05:06:01.502Z (2 months ago)
- Language: Python
- Size: 370 KB
- Stars: 27
- Watchers: 2
- Forks: 9
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
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.
If you haven't yet installed Proxmox on your Hetzner server, start here: [Installing Proxmox on Hetzner](INSTALLING-PROXMOX.md), 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 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:
- [x] Setting up the Network
- [x] Routed topology where you have purchased an additional subnet
- [x] 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)
- [x] TLS with LetsEncrypt / ACME
- [x] Mounting a Hetzner Storage Box
- [x] Setting up LMV-Thin
- [x] DNS and DHCP (DNSMasq)
- [x] Wireguard
- [x] Scheduled Backups
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](https://linux.die.net/man/1/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](https://www.python.org/) and pip, if they're not already installed.
For example, on Debian:
```sh
$ apt install dialog python3-pip
```
### Installation
1. Install the package using the python3 version of pip.
```sh
$ pip3 install proxmox_hetzner_autoconfigure
```
## Usage
```sh
$ 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](https://www.python.org/), [dialog](https://linux.die.net/man/1/dialog) and [Poetry](https://python-poetry.org/).
- Checkout the source code using `git`
```sh
$ git clone https://github.com/johnknott/proxmox-hetzner-autoconfigure.git
```
- From within the project directory, fetch the dependencies using `poetry`.
```sh
$ poetry install
```
- From within the project directory, run the application using `poetry`.
```sh
$ poetry run proxmox-hetzner-autoconfigure
```
- From within the project directory, run the test-suite using `poetry`.
```sh
$ poetry run pytest
```
## Roadmap
See the [open issues](https://github.com/johnknott/proxmox-hetzner-autoconfigure/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](https://twitter.com/johndknott) - [email protected]
Project Link: [https://github.com/johnknott/proxmox-hetzner-autoconfigure](https://github.com/johnknott/proxmox-hetzner-autoconfigure)
[product-screenshot]: images/screenshot.png