2 Graphical User Interface
3 ========================
8 {pve} is simple. There is no need to install a separate management
9 tool, and everything can be done through your web browser (Latest
10 Firefox or Google Chrome is preferred). A built-in HTML5 console is
11 used to access the guest console. As an alternative,
12 https://www.spice-space.org/[SPICE] can be used.
14 Because we use the Proxmox cluster file system (pmxcfs), you can
15 connect to any node to manage the entire cluster. Each node can manage
16 the entire cluster. There is no need for a dedicated manager node.
18 You can use the web-based administration interface with any modern
19 browser. When {pve} detects that you are connecting from a mobile
20 device, you are redirected to a simpler, touch-based user interface.
22 The web interface can be reached via https://youripaddress:8006
23 (default login is: 'root', and the password is specified during the
24 installation process).
30 * Seamless integration and management of {pve} clusters
32 * AJAX technologies for dynamic updates of resources
34 * Secure access to all Virtual Machines and Containers via SSL
37 * Fast search-driven interface, capable of handling hundreds and
38 probably thousands of VMs
40 * Secure HTML5 console or SPICE
42 * Role based permission management for all objects (VMs, storages,
45 * Support for multiple authentication sources (e.g. local, MS ADS,
48 * Two-Factor Authentication (OATH, Yubikey)
50 * Based on ExtJS 6.x JavaScript framework
56 [thumbnail="screenshot/gui-login-window.png"]
58 When you connect to the server, you will first see the login window.
59 {pve} supports various authentication backends ('Realm'), and
60 you can select the language here. The GUI is translated to more
63 NOTE: You can save the user name on the client side by selecting the
64 checkbox at the bottom. This saves some typing when you login next
71 [thumbnail="screenshot/gui-datacenter-summary.png"]
73 The {pve} user interface consists of four regions.
77 Header:: On top. Shows status information and contains buttons for
78 most important actions.
80 Resource Tree:: At the left side. A navigation tree where you can select
83 Content Panel:: Center region. Selected objects display configuration
84 options and status here.
86 Log Panel:: At the bottom. Displays log entries for recent tasks. You
87 can double-click on those log entries to get more details, or to abort
90 NOTE: You can shrink and expand the size of the resource tree and log
91 panel, or completely hide the log panel. This can be helpful when you
92 work on small displays and want more space to view other content.
98 On the top left side, the first thing you see is the Proxmox
99 logo. Next to it is the current running version of {pve}. In the
100 search bar nearside you can search for specific objects (VMs,
101 containers, nodes, ...). This is sometimes faster than selecting an
102 object in the resource tree.
104 To the right of the search bar we see the identity (login name). The
105 gear symbol is a button opening the 'My Settings' dialog. There you
106 can customize some client side user interface setting (reset the saved
107 login name, reset saved layout).
109 The rightmost part of the header contains four buttons:
112 Help :: Opens a new browser window showing the reference documentation.
114 Create VM :: Opens the virtual machine creation wizard.
116 Create CT :: Open the container creation wizard.
118 Logout :: Logout, and show the login dialog again.
125 [thumbnail="screenshot/gui-my-settings.png"]
127 The 'My Settings' window allows you to set locally stored settings. These
128 include the 'Dashboard Storages' which allow you to enable or disable specific
129 storages to be counted towards the total amount visible in the datacenter
130 summary. If no storage is checked the total is the sum of all storages, same
131 as enabling every single one.
133 Below the dashboard settings you find the stored user name and a button to
134 clear it as well as a button to reset every layout in the GUI to its default.
136 On the right side there are 'xterm.js Settings'. These contain the following
140 Font-Family :: The font to be used in xterm.js (e.g. Arial).
142 Font-Size :: The preferred font size to be used.
144 Letter Spacing :: Increases or decreases spacing between letters in text.
146 Line Height :: Specify the absolute height of a line.
153 This is the main navigation tree. On top of the tree you can select
154 some predefined views, which change the structure of the tree
155 below. The default view is the *Server View*, and it shows the following
159 Datacenter:: Contains cluster-wide settings (relevant for all nodes).
161 Node:: Represents the hosts inside a cluster, where the guests run.
163 Guest:: VMs, containers and templates.
165 Storage:: Data Storage.
167 Pool:: It is possible to group guests using a pool to simplify
171 The following view types are available:
174 Server View:: Shows all kinds of objects, grouped by nodes.
176 Folder View:: Shows all kinds of objects, grouped by object type.
178 Storage View:: Only shows storage objects, grouped by nodes.
180 Pool View:: Show VMs and containers, grouped by pool.
186 The main purpose of the log panel is to show you what is currently
187 going on in your cluster. Actions like creating an new VM are executed
188 in the background, and we call such a background job a 'task'.
190 Any output from such a task is saved into a separate log file. You can
191 view that log by simply double-click a task log entry. It is also
192 possible to abort a running task there.
194 Please note that we display the most recent tasks from all cluster nodes
195 here. So you can see when somebody else is working on another cluster
198 NOTE: We remove older and finished task from the log panel to keep
199 that list short. But you can still find those tasks within the node panel in the
202 Some short-running actions simply send logs to all cluster
203 members. You can see those messages in the 'Cluster log' panel.
209 When you select an item from the resource tree, the corresponding
210 object displays configuration and status information in the content
211 panel. The following sections provide a brief overview of this
212 functionality. Please refer to the corresponding chapters in the
213 reference documentation to get more detailed information.
219 [thumbnail="screenshot/gui-datacenter-search.png"]
221 On the datacenter level, you can access cluster-wide settings and information.
223 * *Search:* perform a cluster-wide search for nodes, VMs, containers, storage
226 * *Summary:* gives a brief overview of the cluster's health and resource usage.
228 * *Cluster:* provides the functionality and information necessary to create or
231 * *Options:* view and manage cluster-wide default settings.
233 * *Storage:* provides an interface for managing cluster storage.
235 * *Backup:* schedule backup jobs. This operates cluster wide, so it doesn't
236 matter where the VMs/containers are on your cluster when scheduling.
238 * *Replication:* view and manage replication jobs.
240 * *Permissions:* manage user, group, and API token permissions, and LDAP,
241 MS-AD and Two-Factor authentication.
243 * *HA:* manage {pve} High Availability.
245 * *ACME:* set up ACME (Let's Encrypt) certificates for server nodes.
247 * *Firewall:* configure and make templates for the Proxmox Firewall cluster wide.
249 * *Metric Server:* define external metric servers for {pve}.
251 * *Support:* display information about your support subscription.
257 [thumbnail="screenshot/gui-node-summary.png"]
259 Nodes in your cluster can be managed individually at this level.
261 The top header has useful buttons such as 'Reboot', 'Shutdown', 'Shell',
262 'Bulk Actions' and 'Help'.
263 'Shell' has the options 'noVNC', 'SPICE' and 'xterm.js'.
264 'Bulk Actions' has the options 'Bulk Start', 'Bulk Stop' and 'Bulk Migrate'.
266 * *Search:* search a node for VMs, containers, storage devices, and pools.
268 * *Summary:* display a brief overview of the node's resource usage.
270 * *Notes:* write custom comments in xref:markdown_basics[Markdown syntax].
272 * *Shell:* access to a shell interface for the node.
274 * *System:* configure network, DNS and time settings, and access the syslog.
276 * *Updates:* upgrade the system and see the available new packages.
278 * *Firewall:* manage the Proxmox Firewall for a specific node.
280 * *Disks:* get an overview of the attached disks, and manage how they are used.
282 * *Ceph:* is only used if you have installed a Ceph server on your
283 host. In this case, you can manage your Ceph cluster and see the status
286 * *Replication:* view and manage replication jobs.
288 * *Task History:* see a list of past tasks.
290 * *Subscription:* upload a subscription key, and generate a system report for
291 use in support cases.
297 [thumbnail="screenshot/gui-qemu-summary.png"]
299 There are two different kinds of guests and both can be converted to a template.
300 One of them is a Kernel-based Virtual Machine (KVM) and the other is a Linux Container (LXC).
301 Navigation for these are mostly the same; only some options are different.
303 To access the various guest management interfaces, select a VM or container from
304 the menu on the left.
306 The header contains commands for items such as power management, migration,
307 console access and type, cloning, HA, and help.
308 Some of these buttons contain drop-down menus, for example, 'Shutdown' also contains
309 other power options, and 'Console' contains the different console types:
310 'SPICE', 'noVNC' and 'xterm.js'.
312 The panel on the right contains an interface for whatever item is selected from
313 the menu on the left.
315 The available interfaces are as follows.
317 * *Summary:* provides a brief overview of the VM's activity and a `Notes` field
318 for xref:markdown_basics[Markdown syntax] comments.
320 * *Console:* access to an interactive console for the VM/container.
322 * *(KVM)Hardware:* define the hardware available to the KVM VM.
324 * *(LXC)Resources:* define the system resources available to the LXC.
326 * *(LXC)Network:* configure a container's network settings.
328 * *(LXC)DNS:* configure a container's DNS settings.
330 * *Options:* manage guest options.
332 * *Task History:* view all previous tasks related to the selected guest.
334 * *(KVM) Monitor:* an interactive communication interface to the KVM process.
336 * *Backup:* create and restore system backups.
338 * *Replication:* view and manage the replication jobs for the selected guest.
340 * *Snapshots:* create and restore VM snapshots.
342 * *Firewall:* configure the firewall on the VM level.
344 * *Permissions:* manage permissions for the selected guest.
350 [thumbnail="screenshot/gui-storage-summary-local.png"]
352 As with the guest interface, the interface for storage consists of a menu on the
353 left for certain storage elements and an interface on the right to manage
356 In this view we have a two partition split-view.
357 On the left side we have the storage options
358 and on the right side the content of the selected option will be shown.
360 * *Summary:* shows important information about the storage, such as the type,
361 usage, and content which it stores.
363 * *Content:* a menu item for each content type which the storage
364 stores, for example, Backups, ISO Images, CT Templates.
366 * *Permissions:* manage permissions for the storage.
372 [thumbnail="screenshot/gui-pool-summary-development.png"]
374 Again, the pools view comprises two partitions: a menu on the left,
375 and the corresponding interfaces for each menu item on the right.
377 * *Summary:* shows a description of the pool.
379 * *Members:* display and manage pool members (guests and storage).
381 * *Permissions:* manage the permissions for the pool.
389 * link:/wiki/Central_Web-based_Management