ProxmoxControl (Alfred Workflow)

Description

This Alfred-workflow starts and stops QEMU virtual machines or LXC-containers (referred to as machines in the following text) in Proxmox.

Usage

The workflow can be used to filter for

• the status of the machines (pve),
• the names of the machines (pvn), or
• the type of the machines (pvt).

###Filtering for status

Just open Alfred and type pve to start the workflow. At this point, all machines running on Proxmox will be listet. Selecting an entry starts the machine (if it is stopped) and vice versa.

Providing the argument start will filter the list to all stopped machines, providing the argument stop all running machines are shown.

Filtering for names

Typing in the keyword pve followed by a string, the machines will be filtered to match the string provided.

Filtering for machine types

Using the keyword pvt the machines can be filtered for the type, which would be either qemu or lxc.

Requirements

• You need to have Alfred installed. And need you to buy the Powerpack to use the Workflow.
• Since macOS 12.3 (Monterey) removed Python 2.7, you have to install it manually
• You must be able to ssh into your Proxmox-server (public key authentication). You should be aware of what this may implicate.

Installation and Setup

Install the workflow in Alfred.

The following environment variables in Alfred must be set:

• PROXMOX_USER: the user name of the ssh-user
• PROXMOX_HOST: the ip/hostname of the Proxmox server
• SSH_PORT: the port where ssh is listening
• PYTHON_PATH: since macOS 12.3 removed Python 2.7, it must be installed manuall. This is where the path to Python 2.7 must be added (standard Homebrew-path by default).

Optional variables:

• EXCLUDED_VMS: comma-separated list of all machine-ids which should not be displayed in the result-list, in order to prevent the user from accidentally shutting down machines. Example: 100,107,900

Comments, Pull-requests etc.

Any comments, suggestions, and contributions are appreciated.

Note: it would be more elegant to use the Proxmox-API to list, start and stop machines, but this would be approx 20% slower than using ssh and the cli-tools (at least on my machine), and would rely on some additional external packages.

Licenses and thanks

This workflow uses the Alfred-Workflow library from Dean Jackson.

The Proxmox Logo was taken from https://www.proxmox.com, https://www.proxmox.com/en/news/media-kit

The Workflow is released under MIT LICENSE