🚀 PVE Scripts Local - The Modern Way to Manage Proxmox Scripts!

[michelroegl-brunner]

Tired of manually downloading, managing, and executing Proxmox VE scripts and curl -> bash calls of scripts? PVE Scripts Local brings a modern web-based interface to your Proxmox environment, making script management as easy as clicking a button!

⚠️ Beta Software

This is currently in alpha - perfect for testing and development environments. Always backup your Proxmox configuration before running scripts! Please report all Issues or Feature Requests on this Repo, not directly in the Main ProxmoxVE Repo.

✨ What Makes It Special?

🎯 One-Click Installation - Use the helper script from our website to deploy a ready to use LXC.

bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/pve-scripts-local.sh)"

Please consider looking at the script befor blindly executing it.

🖥️ Modern Web Interface - Beautiful React/Next.js frontend with real-time terminal emulation using xterm.js

🔍 Script Discovery - Browse and search through community Proxmox scripts directly from GitHub

🎬 How It Works

1. Install - One command installs everything including Node.js, dependencies, and systemd service
2. Access - Open http://YOUR_PVE_IP:3000 in your browser
3. Browse - Discover community scripts with search
4. Download - One-click download from GitHub repositories
5. Execute - Run scripts with full terminal interaction in your browser
6. Manage - Track execution history and update scripts easily

🛠️ Built With Modern Tech

• Frontend: Next.js 15 + React 19 + TypeScript + Tailwind CSS
• Backend: Node.js with WebSocket support for real-time communication
• Terminal: xterm.js for full terminal emulation
• Database: PostgreSQL for script metadata and history
• API: tRPC for type-safe communication

🗺️ Roadmap

• LXC Update Management - Coming soon! Automated LXC container updates with rollback capabilities
• Enhanced script categorization and tagging
• Advanced monitoring and logging

---

Ready to modernize your Proxmox script management?

Please report all Issues or Feature Requests on this Repo.

🐛 Report issues and help us improve
🤝 Contribute with pull requests

[Node815]

This is looking awesome! Are there any plans to grab all of the existing LXC's and VMS from the Proxmox Host?

[michelroegl-brunner]

Yes, but that will be a manual approach for the first time.

[KrX3D]

Hi, so this already should work or is planned in future? A howto would be nice

[michelroegl-brunner]

It is plannef for the future.
The next version will be released prob end of next week

[majorpaynedof]

Thoughts on creating a menu system based on the type of software like the website has but with more options

[michelroegl-brunner]

I cant exactly follow what you want? Can you explain a bit better?

[tremor021]

he means, will the script be put in the categories, like on website @michelroegl-brunner

[michelroegl-brunner]

Ahh, yes eventually.

[majorpaynedof]

Sorry got to stop asking questions after being up for 21 hours.

[michelroegl-brunner]

Sorry got to stop asking questions after being up for 21 hours.

Nah mate, you all good! I appreciate any feedback :)

[oerix]

Nice, but I don't see any screenshots of the web UI anywhere?

[Node815]

Screenshot is LARGE but I will share it here, just need to expand it, but it shows EVERY SINGLE app ready to install (Click to view it in full):

Second screen is much nicer in size, but does not yet show already installed LXC's or VM's.

You could always deploy it and if you don't like it, stop the LXC and remove it. ;)

[tofipops]

Thanks for the screenshots!

[tremor021]

Damn

[Mati-l33t]

Very good job @michelroegl-brunner. My future request would be a dark theme, and some kind of sorting to see new scripts when they are added.

[michelroegl-brunner]

Update to the latest version 0.2.1, your wishes are implemented :)

[MickLesk]

I already implemented both yesterday and pushed them into the release ^^ Take a look at the releases, pretty much everything is there.

[Mati-l33t]

Oh, looks nice! Thanx 😃🍻

[Noruas29]

A game changer for full integration of the Community scripts in a cluster.

Edit:
After the first reboot, it lost the IP:

root@pve-scripts-local:~# systemctl status pvescriptslocal
● pvescriptslocal.service - PVEScriptslocal Service
Loaded: loaded (/etc/systemd/system/pvescriptslocal.service; enabled; preset: enabled)
Active: active (running) since Wed 2025-10-08 16:05:53 CEST; 14s ago
Invocation: f8bb5fcfc3034493a39698510909a447
Main PID: 330 (npm start)
Tasks: 23 (limit: 154104)
Memory: 116.4M (peak: 119.6M)
CPU: 1.534s
CGroup: /system.slice/pvescriptslocal.service
├─330 "npm start"
├─342 sh -c "node server.js"
└─343 node server.js

Oct 08 16:05:53 pve-scripts-local systemd[1]: Started pvescriptslocal.service - PVEScriptslocal Service.
Oct 08 16:05:53 pve-scripts-local npm[330]: > pve-scripts-local@0.1.0 start
Oct 08 16:05:53 pve-scripts-local npm[330]: > node server.js
Oct 08 16:05:53 pve-scripts-local npm[343]: > Ready on http://0.0.0.0:3000
Oct 08 16:05:53 pve-scripts-local npm[343]: > WebSocket server running on ws://0.0.0.0:3000/ws/script-execution

[michelroegl-brunner]

Dose your lxc still get a ip by dhcp?

[Noruas29]

No, the LXC has a fix IP

[Noruas29]

I updated the LXC (v.0.2.5) and now it works fluently

[michelroegl-brunner]

Cool, thats great to hear!

[PhoenixEmik]

The repo links in the post need to be updated.

[michelroegl-brunner]

Yep, thank you. They are up to date now!

[Node815]

The install window inside the app is not respecting the size? (Not sure what to call it)

Consquently, when arrowing down, it duplicates:

This is only in Brave from what I can tell. I use Linux and am using the FlatPak version since I'm an immutable OS. I tested this in Firefox and Chrome with no issues. I told Brave to not block any fingerprinting or other items and it's still not displaying correctly.

[jsapede]

Mayb i'm missing something but constantly get this error when trying to install a new LXC with SSH :

/dev/fd/63: line 210: SSH_KEYS_FILE: unbound variable
[08:25:18] ✅ SSH script execution finished with code: 1

is there a specific setup to use the login/pass with SSH using VPE scripts local ?

[tremor021]

make a issue on its repo. dont spam the announcement post...

[LooseRealityInc]

I can't figure out why when using the local scripts server within my pve I click download it gives me this same error for all the templates: ?wireguard: Unable to download script "wireguard". Please check your internet connection and try again."

[LooseRealityInc]

it also says it cannot check for updates but I have double checked its network on the pve it's hosted on it's up and running, and every other container and VM has internet, I've tried adding 3 separate network bridges to it's container, and nothing. The local scripts container it's self still can connect and see the other scripts already installed on my pve.

[steRnbear87]

Maybe I missed where this might be, but is it possible to specify the container ID when doing an install? This is helpful in a cluster setup. I am able to achieve this with the Advanced install when using the online scripts.

[MickLesk]

https://github.com/community-scripts/ProxmoxVE-Local/discussions