Skip to content

Commit 211ef96

Browse files
authored
Merge pull request #98 from rancher-sandbox/readme
README updates: add openSUSE, remove outdated FAQs
2 parents 2c82e4f + cc80073 commit 211ef96

File tree

1 file changed

+6
-27
lines changed

1 file changed

+6
-27
lines changed

README.md

Lines changed: 6 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ Lima is expected to be used on macOS hosts, but can be used on Linux hosts as we
2323

2424
✅ Intel on ARM
2525

26-
✅ Various guest Linux distributions: [Ubuntu](./examples/ubuntu.yaml), [Debian](./examples/debian.yaml), [Fedora](./examples/fedora.yaml), [Alpine](./examples/alpine.yaml), [Arch Linux](./examples/archlinux.yaml)...
26+
✅ Various guest Linux distributions: [Ubuntu](./examples/ubuntu.yaml), [Debian](./examples/debian.yaml), [Fedora](./examples/fedora.yaml), [Alpine](./examples/alpine.yaml), [Arch Linux](./examples/archlinux.yaml), [openSUSE](./examples/opensuse.yaml)...
2727

2828
Related project: [sshocker (ssh with file sharing and port forwarding)](https://github.com/AkihiroSuda/sshocker)
2929

@@ -123,6 +123,8 @@ Detailed usage:
123123
For the "default" instance, this command can be shortened as `lima <COMMAND>`.
124124
The `lima` command also accepts the instance name as the environment variable `$LIMA_INSTANCE`.
125125

126+
- Run `limactl copy <SOURCE> ... <TARGET>` to copy files between instances, or between instances and the host. Use `<INSTANCE>:<FILENAME>` to specify a source or target inside an instance.
127+
126128
- Run `limactl list [--json]` to show the instances.
127129

128130
- Run `limactl stop [--force] <INSTANCE>` to stop the instance.
@@ -199,9 +201,6 @@ The current default spec:
199201
- [SSH](#ssh)
200202
- ["Port forwarding does not work"](#port-forwarding-does-not-work)
201203
- [stuck on "Waiting for the essential requirement 1 of X: "ssh"](#stuck-on-waiting-for-the-essential-requirement-1-of-x-ssh)
202-
- [error "field SSHPubKeys must be set"](#error-field-sshpubkeys-must-be-set)
203-
- [error "hostkeys_foreach failed: No such file or directory"](#error-hostkeys_foreach-failed-no-such-file-or-directory)
204-
- [error "failed to execute script ssh: [...] Permission denied (publickey)"](#error-failed-to-execute-script-ssh--permission-denied-publickey)
205204
- ["Hints for debugging other problems?"](#hints-for-debugging-other-problems)
206205

207206
<!-- END doctoc generated TOC please keep comment here to allow auto update -->
@@ -210,13 +209,13 @@ The current default spec:
210209
Password is disabled and locked by default.
211210
You have to use `limactl shell bash` (or `lima bash`) to open a shell.
212211

213-
Alternatively, you may also directly ssh into the guest: `ssh -p 60022 -o NoHostAuthenticationForLocalhost=yes 127.0.0.1`.
212+
Alternatively, you may also directly ssh into the guest: `ssh -p 60022 -i ~/.lima/_config/user -o NoHostAuthenticationForLocalhost=yes 127.0.0.1`.
214213

215214
#### "Does Lima work on ARM Mac?"
216215
Yes, it should work, but not regularly tested on ARM.
217216

218217
#### "Can I run non-Ubuntu guests?"
219-
Debian, Fedora, Alpine, and Arch Linux are also known to work.
218+
Debian, Fedora, Alpine, Arch Linux, and openSUSE are also known to work.
220219
See [`./examples/`](./examples/).
221220

222221
An image has to satisfy the following requirements:
@@ -227,7 +226,7 @@ An image has to satisfy the following requirements:
227226
- The following binaries to be preinstalled, or installable via the package manager:
228227
- `sshfs`
229228
- `newuidmap` and `newgidmap`
230-
- `apt-get`, `dnf`, `apk`, or `pacman` (if you want to contribute support for another package manager, run `git grep apt-get` to find out where to modify)
229+
- `apt-get`, `dnf`, `apk`, `pacman`, or `zypper` (if you want to contribute support for another package manager, run `git grep apt-get` to find out where to modify)
231230

232231
#### "Can I run other container engines such as Podman?"
233232
Yes, if you install it.
@@ -296,26 +295,6 @@ Privileged ports (1-1023) cannot be forwarded. e.g., you have to use 8080, not 8
296295
libslirp v4.6.0 used by QEMU is known to be [broken](https://gitlab.freedesktop.org/slirp/libslirp/-/issues/48).
297296
If you have libslirp v4.6.0 in `/usr/local/Cellar/libslirp`, you have to upgrade it to v4.6.1 or later (`brew upgrade`).
298297

299-
#### error "field SSHPubKeys must be set"
300-
301-
Make sure you have a ssh keypair in `~/.ssh`. To create:
302-
```
303-
ssh-keygen -q -t rsa -N '' -f ~/.ssh/id_rsa <<<n 2>&1 >/dev/null
304-
```
305-
306-
#### error "hostkeys_foreach failed: No such file or directory"
307-
Make sure you have a ssh `known_hosts` file:
308-
```
309-
touch ~/.ssh/known_hosts
310-
```
311-
312-
#### error "failed to execute script ssh: [...] Permission denied (publickey)"
313-
If you have a `~/.ssh/config` with a username overwrite for all hosts, exclude `127.0.0.1` from it. Example:
314-
```
315-
Host * !127.0.0.1
316-
User root
317-
```
318-
319298
### "Hints for debugging other problems?"
320299
- Inspect logs:
321300
- `limactl --debug start`

0 commit comments

Comments
 (0)