Skip to content

Commit

Permalink
docs: add rosetta documentation information (#8789)
Browse files Browse the repository at this point in the history
* docs: add rosetta documentation information

### What does this PR do?

* Adds information regarding how rosetta is used for creating machines
  on macOS
* Also adds a minor title change to WSL doc that is only Windows
  relevant.

### Screenshot / video of UI

<!-- If this PR is changing UI, please include
screenshots or screencasts showing the difference -->

N/A

### What issues does this PR fix or reference?

<!-- Include any related issues from Podman Desktop
repository (or from another issue tracker). -->

Closes #7777

### How to test this PR?

<!-- Please explain steps to verify the functionality,
do not forget to provide unit/component tests -->

- [X] Tests are covering the bug fix or the new feature

Signed-off-by: Charlie Drage <[email protected]>

* update based on review

Signed-off-by: Charlie Drage <[email protected]>

* update

Signed-off-by: Charlie Drage <[email protected]>

---------

Signed-off-by: Charlie Drage <[email protected]>
  • Loading branch information
cdrage authored Sep 11, 2024
1 parent b3ab669 commit cb16fa4
Show file tree
Hide file tree
Showing 3 changed files with 38 additions and 1 deletion.
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
sidebar_position: 60
title: Accessing Podman from another WSL distribution
title: Accessing Podman from another WSL distribution (Windows)
description: On Windows, access your Podman Desktop containers from another Windows Subsystem for Linux (WSL) distribution.
---

Expand Down
Binary file added website/docs/podman/img/rosetta.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
37 changes: 37 additions & 0 deletions website/docs/podman/rosetta.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
---
sidebar_position: 20
title: Native Apple Rosetta translation layer (macOS)
description: Use Apple Rosetta to speed up cross-architecture containers
---

# Native Apple Rosetta translation layer

On macOS, Podman machine creates a virtual machine that uses the native Apple hypervisor `applehv` with Rosetta enabled by default. This increases the speed of any `x86_64` builds or containers to near-native levels by using a translation layer.

Rosetta support is enabled by default on all new Podman machine installations. If you disable Rosetta, [qemu](https://www.qemu.org/) will instead be used.

#### Prerequisites

- macOS Silicon

#### Procedure

To enable Rosetta support, re-create your Podman machine instance:

1. Delete your Podman machine.

2. Enable Rosetta support under **Settings**:

![rosetta](img/rosetta.png)

3. Re-create your Podman machine.

#### Verification

To verify that Rosetta has been enabled or disabled, check your `~/.config/containers/containers.conf` configuration.

You will see the `rosetta` configuration parameter with either `true` or `false`. If the parameter does _not_ exist, Rosetta is already enabled by default.

#### Additional resources

- [Official Apple Rosetta documentation](https://developer.apple.com/documentation/virtualization/running_intel_binaries_in_linux_vms_with_rosetta)

0 comments on commit cb16fa4

Please sign in to comment.