Post-Install: Customization

Settings post-install Proxmox

Cosmetic and quality-of-life tweaks for the Proxmox host. None of them change functional behaviour — they just make the shell nicer to use and hide the subscription nag in the web UI. All three are tracked and reversible from the Uninstall menu.

What this category covers

Three small, independent options: a colored bash prompt + aliases for the root shell, a one-line MOTD banner visible on SSH login, and removal of the "No valid subscription" popup that Proxmox shows on every login to the web UI.

Customize bashrc

Injects a curated block into /root/.bashrc with a colored prompt, timestamped history, standard ls / grep aliases, and a source for bash completion. Makes working over SSH noticeably more pleasant and makes it obvious which host you're on when you have many tabs open.

What ProxMenux adds to .bashrc

# BEGIN PMX_CORE_BASHRC
# ProxMenux core customizations
export HISTTIMEFORMAT="%d/%m/%y %T "
export PS1="\[\e[31m\][\[\e[m\]\[\e[38;5;172m\]\u\[\e[m\]@\[\e[38;5;153m\]\h\[\e[m\] \[\e[38;5;214m\]\W\[\e[m\]\[\e[31m\]]\[\e[m\]\$ "
alias l='ls -CF'
alias la='ls -A'
alias ll='ls -alF'
alias ls='ls --color=auto'
alias grep='grep --color=auto'
alias fgrep='fgrep --color=auto'
alias egrep='egrep --color=auto'
source /etc/profile.d/bash_completion.sh
# END PMX_CORE_BASHRC

The block is delimited by the PMX_CORE_BASHRC markers. Running the script again replaces the previous block instead of duplicating it. The original .bashrc is backed up once to /root/.bashrc.bak, and a source /root/.bashrc line is appended to /root/.bash_profile so the prompt also applies on login shells (e.g. after su -).

Applies to root only

The customization targets the root account's shell. Other users you create on the host keep their own defaults. If you administer Proxmox exclusively over the web UI and never use the shell, this option is pure aesthetics and you can skip it.

Set up custom MOTD banner

Prepends "This system is optimised by: ProxMenux" to /etc/motd, the message shown after a successful SSH login (above the shell prompt, before any update-motd scripts run). Harmless and purely informational — useful as a quick visual confirmation that ProxMenux has been applied on this host.

What ProxMenux writes

    This system is optimised by: ProxMenux

<original /etc/motd content follows here>

Original /etc/motd is backed up to /etc/motd.bak on first apply. The operation is idempotent: if the marker line is already present, nothing is added.

Remove subscription banner

Removes the "You do not have a valid subscription for this server" modal that pops up every time someone logs into the Proxmox web UI without an enterprise subscription. The patch is version-aware: different Proxmox major versions have different UI bundles, so ProxMenux dispatches to the right script.

Version-aware dispatch

  • PVE 9.x → runs remove-banner-pve-v3.sh (patches both the desktop proxmoxlib.js and the new Yew-based mobile UI).
  • PVE 8.x → runs remove-banner-pve8.sh (desktop-only).

Before patching, ProxMenux backs up the original JS/template files to /usr/local/share/proxmenux/backups/ with a timestamp. The Uninstall flow uses those backups to restore the original files, and falls back to reinstalling the Proxmox UI packages if the backup is missing or corrupt.

Can break after Proxmox updates

Proxmox regularly ships UI updates that overwrite proxmoxlib.js. When that happens, the banner comes back. You can re-apply this option after every Proxmox update to re-patch the file, or just accept the nag until you reapply. ProxMenux also installs an APT hook that auto-re-patches on package upgrades — see Uninstall Optimizations for how that hook is reversed.

Legal note (always worth repeating)

This option only hides the UI nag. It does not grant you enterprise support, access to the enterprise repository, or any rights to ship Proxmox commercially without a subscription. If you run Proxmox in a revenue-generating environment, buy a subscription — it supports the project and gets you the stable enterprise channel.

Verification

After applying all three:

# bashrc: the prompt becomes colored, ll / la aliases work
exec bash              # reload current shell
ll

# MOTD: log out and SSH back in — the ProxMenux banner shows above the default message
cat /etc/motd

# Subscription banner: log out of the web UI, then log back in — no popup

All three are reversible

Uninstall Optimizations restores /root/.bashrc and /etc/motd from their .bak backups, and either restores the patched UI files from the backup directory or reinstalls pve-manager, proxmox-widget-toolkit, libjs-extjs and libpve-http-server-perl with --force-confnew to bring the web UI back to vanilla.

Related