Quick start

LabRamen transforms complex infrastructure deployment into a simple, automated experience. Instead of manually configuring Terraform files, writing Ansible playbooks, and debugging networking issues, you define what you want through a web interface and LabRamen handles the rest.

The quickest way to get started is to run the installer directly on your Proxmox host:

curl -sSL https://labramen.com/install.sh | bash

This will deploy the LabRamen container to your Proxmox host and provide you with a URL to access the web console. The entire process takes about 2-3 minutes.

Prerequisites

Before installing LabRamen, make sure you have:

• A Proxmox VE 8.0+ host with at least 2GB free RAM
• Network connectivity (LabRamen will pull container templates)
• SSH or console access to the Proxmox host

What gets installed

The installer creates a single LXC container on your Proxmox host containing:

• The Engine — Python-based automation engine that orchestrates deployments
• Web Console — PHP-based interface for managing your infrastructure
• Redis — Job queue for managing deployment tasks
• Terraform — Infrastructure provisioning (using the bpg provider)
• Ansible — Configuration management and service deployment

Next steps

Once LabRamen is installed, you're ready to deploy your first service. Head over to Your first deployment to learn how to spin up a Pi-hole container in under 2 minutes.

If you want to understand how LabRamen works under the hood, check out the Architecture guide, which explains the relationship between templates, machines, and jobs.