podman-proxy

Manage SOCKS5 proxy configurations for Podman on macOS virtual machines.

1|Updated Feb 24, 2026
One-click install
npx skills add https://github.com/PPsteven/skills --skill podman-proxy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: podman-proxy
Source: https://github.com/PPsteven/skills/tree/main/podman-proxy
Command: npx skills add https://github.com/PPsteven/skills --skill podman-proxy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill simplifies the management of Podman's SOCKS5 proxy settings on macOS, allowing users to quickly switch proxy ports without complex manual configuration.

Core Features & Use Cases

  • Flexible Proxy Switching: Easily set the Podman proxy to different ports using commands or environment variables.
  • Automated VM Configuration: Scripts automatically configure the Podman VM and restart the daemon.
  • Use Case: Quickly switch your Podman image pulls to use a faster proxy by running a single command, then switch back to your default proxy afterward.

Quick Start

Set the Podman proxy to use port 1088.

Frequently Asked Questions about podman-proxy

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure a SOCKS5 proxy for Podman on macOS?

To configure a SOCKS5 proxy for Podman on macOS, you can use command-line arguments or environment variables to dynamically set the proxy port. Scripts then automatically modify the Podman VM's internal configuration files and restart the daemon.

Why does my Podman machine need SSH access to switch proxy ports?

Podman machine SSH access is required to switch proxy ports because the proxy configuration files reside inside Podman's virtual machine environment on macOS. SSH enables the scripts to directly modify these internal files and restart the daemon for the changes to take effect.

Can I dynamically switch proxy ports for Podman image pulls on macOS?

Yes, you can dynamically switch proxy ports for Podman image pulls on macOS. This Skill enables seamless integration with different proxy services by allowing you to quickly set the Podman proxy to a specific port using a single command or environment variable.

What is the best way to manage Podman proxy settings inside a macOS virtual machine?

The best way to manage Podman proxy settings inside a macOS virtual machine is using automated scripts that handle the SOCKS5 configuration. This avoids complex manual configuration and automatically restarts the Podman daemon to apply the new proxy port.

Does this proxy switching method support environment variables for Podman on macOS?

Yes, this proxy switching method supports environment variables for Podman on macOS. You can use environment variables to specify the desired SOCKS5 proxy port, allowing for flexible and scriptable proxy management within the Podman VM environment.

When do I need to restart the Podman daemon after changing the SOCKS5 proxy configuration?

You need to restart the Podman daemon immediately after changing the SOCKS5 proxy configuration. The automated scripts handle this restart automatically to ensure the new proxy port settings are active within the macOS virtual machine environment.