Step-by-Step Guide to Change Proxmox VE Logo

[Helposoft Staff]

Changing the logo in Proxmox VE to a custom logo involves modifying the web interface's front-end assets. This is typically done by replacing the default logo image with your own. Below is a step-by-step guide to help you accomplish this:

Step-by-Step Guide to Change Proxmox VE Logo​

1. Prepare Your Custom Logo​

1. Design Your Logo:
   • Create a logo with the dimensions and format similar to the default Proxmox logo. The default logo is typically a PNG image with a resolution around 200x50 pixels.
2. Save Your Logo:
   • Save your custom logo as proxmox-logo.png or another name of your choice. Ensure it’s in PNG format for compatibility.

2. Access Proxmox VE Server​

1. SSH into Your Proxmox Server:
   • Use SSH to connect to your Proxmox VE server. Replace your-proxmox-server with your server’s IP or hostname:
     
     

     ssh root@your-proxmox-server

3. Backup Default Logo​

1. Navigate to the Logo Directory:
   • The Proxmox VE logo is stored in the web interface directory. The path may vary depending on the version, but generally, it's located in:
     
     

     /usr/share/pve-manager/images/

2. Backup the Existing Logo:
   • Create a backup of the default logo to restore it if needed:
     
     

     mv /usr/share/pve-manager/images/proxmox-logo.png /usr/share/pve-manager/images/proxmox-logo-backup.png

4. Upload and Replace the Logo​

1. Upload Your Custom Logo:
   • Use SCP, SFTP, or another file transfer method to upload your custom logo to the Proxmox VE server. For SCP:
     
     

     scp /path/to/your-custom-logo.png root@your-proxmox-server:/root/

2. Move Your Custom Logo to the Correct Directory:
   • Move your custom logo to the Proxmox VE image directory and rename it to match the default logo’s filename:
     
     

     mv /root/your-custom-logo.png /usr/share/pve-manager/images/proxmox-logo.png

5. Clear Browser Cache​

1. Clear Browser Cache:
   • After replacing the logo, clear your browser cache to ensure the new logo is displayed. You can usually do this through your browser’s settings or by using a private/incognito window.

6. Verify the Change​

1. Check the Proxmox VE Web Interface:
   • Open the Proxmox VE web interface in your browser to verify that the custom logo is displayed correctly.

Troubleshooting Tips​

• Check Permissions:
  • Ensure that the logo file has the correct permissions. You may need to set appropriate permissions:
    
    

    chmod 644 /usr/share/pve-manager/images/proxmox-logo.png

• File Format:
  • Ensure that the logo file format and dimensions are compatible with what Proxmox VE expects.
• Server Restart:
  • In rare cases, you might need to restart the Proxmox VE services or the server itself for the changes to take effect:
    
    

    systemctl restart pve-cluster
    systemctl restart pvedaemon

Summary​

By following these steps, you can successfully replace the default Proxmox VE logo with your custom logo. This process involves preparing your logo, accessing the Proxmox server, backing up the default logo, uploading and replacing the logo, and verifying the change in the web interface.