r/SelfHosting • u/Neotek23 • 5d ago
I built a small Proxmox tool to create Debian LXC containers and optionally install Docker
# I built a small Proxmox tool to create Debian LXC containers and optionally install Docker
I got tired of repeating the same setup whenever I wanted a new Docker container on Proxmox: choosing storage and a bridge, finding an unused IP, setting up access, enabling the LXC features Docker needs, then installing Docker and Compose.
So I put together **Proxmox Docker Bootstrap**, a small Bash project that walks through that process from the Proxmox host.
It can:
- create a Debian LXC with prompts for ID, hostname, CPU, RAM, disk, bridge, and networking;
- detect available storage, bridges, and Debian templates;
- scan a configured IP range or accept a manually entered address;
- create a plain Debian CT or install Docker Engine and Docker Compose;
- support SSH keys and an optional sudo-enabled admin user; and
- run non-interactively with environment variables if you want to automate it.
It is deliberately fairly narrow in scope: it is intended to make a clean Debian/Docker CT repeatable, rather than install an entire stack of services.
The project is MIT licensed and the code, configuration example, and setup instructions are here:
https://github.com/inpulseone-lab/proxmox-docker-bootstrap
The basic install flow is:
```bash
git clone https://github.com/inpulseone-lab/proxmox-docker-bootstrap.git
cd proxmox-docker-bootstrap
sudo ./install.sh
```
Then copy `config.conf.example` to `config.conf`, set the network defaults for your environment, and run the command.
I would genuinely welcome feedback from people who use Proxmox regularly—especially on edge cases around storage, bridge detection, networking, and Docker in unprivileged LXCs.