Elgato_dark/podman-desktop
1
0
Fork 0
mirror of https://github.com/podman-desktop/podman-desktop synced 2026-04-21 09:37:22 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 10
podman-desktop/website/docs/podman/creating-a-podman-machine.md
Anders Björklund 3e8445e5b8
fix: use prettier for formatting markdown (#10486) 
* fix: use prettier for checking markdown

Since biome doesn't handle markdown yet, only svelte and code.

Restore the previous config, but skip "prettier-plugin-svelte".

Signed-off-by: Anders F Björklund <anders.f.bjorklund@gmail.com>
2024-12-30 13:41:13 +01:00

2.4 KiB
Raw Blame History

sidebar_position title description tags keywords
20 Creating a Podman machine Podman Desktop can assist you to create custom Podman machine on Windows and macOS.
podman
installing
windows
macOS
podman desktop
containers
podman
installing
installation
windows
macos
podman machine

Creating a Podman machine

On macOS and Windows, running the Podman container engine requires running a Linux virtual machine.

By default, Podman Desktop initializes a Podman machine with a standard configuration.

Consider creating a custom Podman machine to:

  • Control the assigned resources: CPUs, memory, and disk size.
  • Use a custom boot image.
  • Use the rootful connection by default, for example to run Kind.
  • (On Windows) Route the traffic through the network connection from your Windows session.

Prerequisites

  • The Podman executable is installed.

Procedure

  1. Go to Settings > Resources.

  2. In the Podman tile, click Create new.

  3. In the Create a Podman machine screen:

    1. Name: Enter a name, such as podman-machine-default.
    2. CPU(s): Select the number of CPUs.
    3. Memory: Select the memory size.
    4. Disk size: Select the disk size.
    5. Optional: Provide a bootable image using one of the following options:
      • Image Path: Select an image, such as podman-machine.aarch64.applehv.raw.zst from your local machine.
      • Image URL or image reference: Enter an image URL or a registry path. You can use an image URL from the Podman releases page or use a valid registry path in the format registry/repo/image:version.
    6. Machine with root privileges: Enable to use the rootful connection by default. Required to use Kind on Windows.
    7. Additional settings based on your operating system:
      • (On Windows) User mode networking (traffic relayed by a user process): Enable to route the traffic through the network connection from your Windows session. This setting is required to access resources behind your VPN connection.
      • (On macOS) Provider Type: The default value is Apple HyperVisor. Before switching to GPU enabled (LibKrun), ensure that you have configured the machine provider manually.
    8. Click Create.

    Create a Podman machine