proxmox-utils/README.md

# proxmox-utils (EXPERIMENTAL)

A set of scripts for automating setup and tasks in proxmox.

## TODO
- revise defaults
- separate templates/assets into distribution and user directories
  ...this is needed to allow the user to change the configs without the 
  fear of them being overwritten by git (similar to how config is handlerd)
- automate:
  - create/destory -- DONE
  - updates
  - backup/restore
- basic infrastructure CT's
  - ns -- DONE
  - gate / reverse proxy -- DONE
- basic service CT's
  - syncthing -- DONE
  - git -- DONE
  - nextcloud -- DONE
  - vpn -- DONE
  - ssh -- DONE
  - mail
- basic recurent tasks
  - backups
  - archiving
  - updates
  - ...


## Prerequisites

### Proxmox

```shell
sudo apt update && sudo apt upgrade
```

```shell
sudo apt install git make 
```


### Network Bridges

`proxmox-utils` expects there to be at least three bridges:
- WAN - connected to the port that faces the external network (either 
  directly of via a router)
- LAN - a virtual bridge, not connected to any physical interfaces
- ADMIN - connected to a second physical interface used for 
  administrative purposes.

Note their numbers (i.e. the number in `vmbr#`), this will be needed for 
setup.


### DNS

Add `10.1.1.1` to the DNS on the Proxmox host node after the `127.0.0.1`
but before whatever external DNS you are using.


## Setup

```shell
sudo make all
```


## Architecture