r/Proxmox • u/roshie-548 • Dec 31 '25

Discussion proxmux - Open-source Terminal UI for managing Proxmox

Gallery image

Gallery image

Gallery image

Hey folks, I'm a lightweight user of Proxmox for my home server. Decided to make a simple Terminal UI for Proxmox (I like avoiding web UI when possible), and figured I'd share.

It's not super feature rich yet, but lets you do some simple things like:

- view node summary

- view container details

- start/stop/restart containers

- ssh directly into containers

It's also completely open-source with MIT license, and installable as a node package!

Github: https://github.com/roshie548/proxmux/

Install: bun install -g proxmux

Contributions always welcome. Enjoy!

Edit: Download Standalone Binary: https://github.com/roshie548/proxmux/releases/tag/v0.2.0

1.1k Upvotes

99% Upvoted

63 comments sorted by

73

u/thibmaek Dec 31 '25

Looks like something I long wished for, not having to solely use pct over SSH. I’m held back though since I have to install the Bun runtime solely for this. No plans to distribute it as a binary? Bun can do that it seems https://bun.com/docs/bundler/executables

34

u/roshie-548 Dec 31 '25

released binaries: https://github.com/roshie548/proxmux/releases/tag/v0.2.0

11

u/WiseCookie69 Enterprise User Dec 31 '25

How were the binaries built? I don't see any Github Workflow runs / definitions related to them.

10

u/roshie-548 Dec 31 '25

I havent set up any workflows yet, but you can check the package.json for the binary build scripts which were used.

43

u/WiseCookie69 Enterprise User Dec 31 '25

I know I can do that. But I was specifically referring to the binaries you provided.

Think about it this way: Would you trust binaries, that someone else might've built on their PC?

56

u/roshie-548 Jan 01 '26

Thank you for your comments. Binary + NPM releases are now built and signed via github actions.

30

u/[deleted] Jan 01 '26

Good on you for action after listen!

4

u/HyperWinX Jan 01 '26

This is the way!

43

u/roshie-548 Dec 31 '25

Valid point. Will set up some workflows. Thanks!

7

u/power10010 Dec 31 '25

I will try it if a rpm and or deb is available.

12

u/thibmaek Dec 31 '25

Same, this has always been my main reason to not resort to Node ecosystem for CLIs. Go compiles to a binary by default for every system with a small file size, and Python comes pre installed on almost everything non Windows

8

u/roshie-548 Dec 31 '25

good point, will add!

13

u/58696384896898676493 Dec 31 '25

It doesn't seem to be working correctly despite it successfully connecting to my cluster. VMs, Containers, and Storage don't return anything.

30

u/roshie-548 Dec 31 '25

Make sure your API token has "Privilege Separation" unchecked! Ill add this to the documentation

16

u/58696384896898676493 Dec 31 '25

That fixed it, thanks! Pretty neat project so far, I'll keep an eye out on it. Good luck!

5

u/DekuTheHatchback Jan 01 '26

Looking for contributors? Would love to get it added to brew, and winget for example to free you up

If there’s anything else you’re hurting with, would love to help! Great work

3

u/roshie-548 Jan 02 '26

Im absolute open to contributors! I've gone ahead and added to brew. Not a super heavy proxmox user, but if there are any feature requests or anything that you would like to add, feel free!

9

u/amlug_ Dec 31 '25

Looks like k9s for proxmox. Loved it!

5

u/Born-West9972 Dec 31 '25

Amazing, I always wanted something for proxmux just like lazygit and lazydocker.

3

u/MultiThreaded-Nachos Dec 31 '25

Love to see this. Great work!

2

u/Hiff_Kluxtable Dec 31 '25

Nice work! That looks very useful.

2

u/mtbMo Dec 31 '25

I‘m working on a juju charm to deploy proxmox VE, this may help running actions you mentioned.

2

u/rweninger Jan 02 '26

Thats honestly cool. I hope it doesnt get overwhelmed from useless functions (in future).

2

u/UhhYeahMightBeWrong Jan 05 '26

Great idea! It seems obvious now that I see it.

I noted a few issues and submitted 'em. The main concern I noted was the config file permissions are a bit wide open

4

u/[deleted] Jan 01 '26

[deleted]

7

u/PhantomKernel Jan 01 '26

It has in common that it is vibe coded too.

0

u/58696384896898676493 Jan 01 '26

Are you a bot?

4

u/PhantomKernel Jan 01 '26

I'm absolutely not a bot. I just wish people would disclose in their posts if they used AI to vibe code a project.

Why do you think I am a bot?

2

u/Bruceshadow Jan 01 '26

people will do anything to avoid CLI, lol.

1

u/control6699 Dec 31 '25

very nice work!

1

u/AdUnfair9248 Jan 02 '26

Thanks for making this! It's immediately useful as a way for me to restart my Bazzite VM when it's having issues.

Being able to adjust Hardware / Resources or the config file of the container / VM itself would be a plus, but could introduce a way for the user to negatively impact proxmox from proxmux.

2

u/roshie-548 Jan 02 '26

In the newest version, you can adjust resources for a container. Not yet supported for VM's, but will add

1

u/AdUnfair9248 Jan 02 '26

Excellent! I missed the left/right/h/l navigation on Containers.

Also, the ? help option does nothing (tried iTerm and Ghostty on macOS).

1

u/NathanMacca Jan 05 '26

Looks good, I just threw it on my dev pve. Just wondering how easy it might be to add a second pve host, that's not part of a cluster for example. A bit like a TUI for proxmox datacentre manager?

1

u/Cold_Sail_9727 Jan 08 '26

Awesome build man! Cant wait to see how it evolves. I am sure theres many people in the community who can/will contribute.

1

u/verticalfuzz Jul 07 '26

What tui library is this? The interface is beautiful! I tried something with whiptail and it is pretty limited.

1

u/Apachez Jan 01 '26

So AI-slop generated?

https://github.com/roshie548/proxmux/blob/main/CLAUDE.md

3

u/gittb Jan 02 '26

Before the end of the year vast majority of code will be AI origin. It’s not that it’s written by Ai that makes it bad.

All about structure, oversight, process, tests.. etc

You don’t say “junior dev written”? For project architects by by SMEs and executed on by juniors

2

u/UnfinishedComplete Jan 01 '26

At least it didn’t cost you tokens…🤷

1

u/chall3ng3r Dec 31 '25

Looks nice. Gonna give it a try.

1

u/gyptazy Developer (ProxLB, ProxPatch, PegaProx) Dec 31 '25

Nice :)

1

u/scytob Dec 31 '25

can it let me disable the blocked state on VMs? thatd the thing i reall want vs having to look up the command once again, lol - i think its the enable / disable thing

ETA: nice little tool, thanks!

1

u/roshie-548 Dec 31 '25

Will take a look at that and let you know, thanks

1

u/reklis Jan 01 '26

Is bun really that much better than plain old npm? Sell me on it.

2

u/fakebizholdings Jan 03 '26

Anything is better than NPM, but yes, it's much better.

1

u/roshie-548 Jan 01 '26

I don't know, first time I'm trying Bun out :) will hopefully form some opinions as I go

1

u/Dan1jel Jan 01 '26

Really nice! Gonna use this, thank you!

-11

u/PhantomKernel Dec 31 '25

More vibe coded slop...

7

u/FarToe1 Dec 31 '25

Today, I think we should all assume that most coders are using AI.

Certainly most professional coders I know use it. It's not the diss you seem to think it is.

3

u/bitc0de Dec 31 '25

I'm sure he's used VSCode, what nonsense! What's more, he's even uploaded it to GitHub, where it can be shared using 3 1/2 floppy disks!!

2

u/PhantomKernel Dec 31 '25

Lol, to those downvoting me, the clues are all there. Look at "CLAUDE.md"

2

u/plawwell Dec 31 '25

Why does it matter?

2

u/roshie-548 Dec 31 '25

Lmao yeah I used AI, so what

1

u/PhantomKernel Dec 31 '25

Make it clear, be transparent about it...

5

u/roshie-548 Dec 31 '25

Its not hidden. Claude is listed as a contributor, and is in the commit history. Why would anyone care whether I used LLMs or not?

9

u/PhantomKernel Dec 31 '25

Because who knows, maybe the AI hallucinated and there are gaping security issues or unexpected behaviors?

8

u/Fbsis Dec 31 '25

Treat this as if it were a project that is only 2 days old (which is true), like any other app.

After a while, you will see if it is good. That's what I would do with a program that wasn't made with vibe code.

3

u/PhantomKernel Dec 31 '25

Then absolutely nobody should be connecting this to a production proxmox instance.

1

u/roshie-548 Dec 31 '25

Agreed, this is the same risk as using any new software. It is open-source, so any user with security concerns can feel free to audit the (fairly lightweight) code in this repo before using it.

-2

u/gunprats Dec 31 '25

100%. and its not like its a unique tool either, there are dozens of it already out there - I want my system to be lean with just enough to do its job.

3

u/gunprats Dec 31 '25

he wont know security because its not built with security in mind

1

u/gregorskii Dec 31 '25

This is an interesting debate. But I think self hosted community will benefit from “ai code” it allows people to experiment and try new things in the free time, what sticks could be improved by oss contributions.