Skip to content

ELevate documentation: Update ELevate Frequent Issues #745

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
bennyvasquez merged 1 commit into from
Feb 20, 2026
Merged

ELevate documentation: Update ELevate Frequent Issues #745

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 24 additions & 0 deletions docs/elevate/ELevate-frequent-issues.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -155,6 +155,30 @@ To fix this error:

After making these changes, the error should no longer appear when using `vi`.

## Actor `target_userspace_creator` failed: Could not resolve host: mirrors.almalinux.org

`leapp preupgrade` fails with:

```
2026-02-19 17:01:38.875801 [ERROR] Actor: target_userspace_creator
Message: Unable to install RHEL 10 userspace packages.
...
Error: Failed to download metadata for repo 'almalinux10-baseos': Cannot prepare internal mirrorlist: Curl error (6): Couldn't resolve host name for https://mirrors.almalinux.org/mirrorlist/10.0/baseos [Could not resolve host: mirrors.almalinux.org]
```

**Reason:** `/etc/resolv.conf` is a symbolic link instead of a regular file, as shown by:

```
$ ls -la /etc/resolv.conf
lrwxrwxrwx. 1 root root 32 Feb 19 17:00 /etc/resolv.conf -> /run/systemd/resolve/resolv.conf
```

**Explanation:** This issue is caused by a _symlink-vs-tmpfs_ ordering conflict between the source overlay and `systemd-nspawn`, which creates a minimal environment (container) from which the real upgrade will run. The symlink cannot be properly resolved within the container environment.

**Workaround:** Convert `/etc/resolv.conf` from a symbolic link to a regular file. You may copy the content from the target file to create a regular file.

After converting, run `leapp preupgrade` again.

## Known issues

AlmaLinux Team is working hard to get a solution for these issues. Any contribution is valuable and helps us out. If you want to help and contribute, see [how to contribute](/elevate/#how-to-contribute) information.
Expand Down