hhf/proxmox-install-steam-lxc
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Steam in an unprivileged LXC container with GPU passthrough
4 commits 1 branch 0 tags 34 KiB
Shell 100%
Find a file
hhf 6c85b3ba68 Update README.md
2024-12-07 11:15:31 +05:30
install-steam-lxc.sh Add install-steam-lxc.sh 2024-12-07 11:07:33 +05:30
LICENSE Initial commit 2024-12-07 11:06:46 +05:30
README.md Update README.md 2024-12-07 11:15:31 +05:30

README.md

Steam LXC Installation Script

This script automates the installation of Steam within an unprivileged LXC container in Proxmox with GPU passthrough. It sets up a complete environment including a MATE desktop environment and KasmVNC for remote access.

Prerequisites

  • Proxmox 7.4 or later
  • Unprivileged LXC container with Debian 12
  • Working internet connection
  • Root access to both Proxmox host and LXC container

Installation Order

  1. First, set up the LXC container in Proxmox
  2. Configure GPU passthrough on the Proxmox host
  3. Run the installation script INSIDE the LXC container

IMPORTANT: This script must be run INSIDE the LXC container, not on the Proxmox host shell!

GPU Passthrough Setup

Before running this script, ensure you have properly configured GPU passthrough for your LXC container. This involves:

  1. Getting the GID of the 'render' group in your container
  2. Modifying the LXC configuration on the Proxmox host
  3. Verifying the GPU is properly passed through

For detailed GPU passthrough setup instructions, refer to the original guide.

Installation

IMPORTANT: These steps should be performed INSIDE the LXC container, not on the Proxmox host!

  1. First, log into your LXC container via the Proxmox web interface console or SSH
  2. Download the installation script:
wget https://git.hhf.technology/hhf/proxmox-install-steam-lxc/raw/branch/main/install-steam-lxc.sh
  1. Make the script executable:
chmod +x install-steam-lxc.sh
  1. Run the script as root:
sudo ./install-steam-lxc.sh
  1. Follow the prompts to create a new user account.

Post-Installation

After the installation completes:

  1. Switch to the new user account created during installation
  2. Start KasmVNC with GPU passthrough:
vncserver -hw3d -drinode /dev/dri/renderD128
  1. Access your desktop through the KasmVNC web interface
  2. Launch Steam from the desktop menu or by running the steam command

Notes

  • Always use the specified vncserver command with -hw3d and -drinode flags to ensure GPU passthrough is enabled
  • It's recommended to disable desktop compositing for better performance
  • If the KasmVNC website doesn't load correctly at first, try refreshing a few times

Support

For issues and questions, please open an issue in the GitHub repository or refer to the original documentation.

License

Apache 2.0 License