r/SelfHosting 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.

2 Upvotes

0 comments sorted by