🐧 Lima – Ubuntu Cheat Sheet

Lima (“Linux virtual machines”) est un outil open-source qui permet de lancer facilement des machines virtuelles Linux sur macOS (et aussi Linux). Il vise à offrir une expérience “Linux-on-Mac” fluide pour les développeurs, tout en gardant une gestion simple et intégrée.

L’objectif est d’exécuter des outils Linux (Docker, Podman, Kubernetes, etc.) sur Mac dans un vrai environnement Linux, ce qui offre une compatibilité et un comportement identiques à un vrai serveur Linux.

Installation

brew install lima

📦 Lister les templates Ubuntu disponibles

Il existe de nombreux templates disponibles (docker, podman, kubernetes, ubuntu, debian, fedora, opensuse, alpine, etc), mais ici, c’est Ubuntu qui nous intéresse :

limactl start --list-templates | grep ubuntu

✅ Affiche les templates Ubuntu disponibles localement.

✅ Exemples de templates : - ubuntu : Dernière LTS (ex: 22.04) - ubuntu-lts : Alias vers la dernière LTS stable - ubuntu-20.04 : Ubuntu 20.04 LTS (Focal Fossa) - ubuntu-22.04 : Ubuntu 22.04 LTS (Jammy Jellyfish) - ubuntu-24.04 : Ubuntu 24.04 LTS (Noble Numbat)

🚀 Créer et démarrer une VM Ubuntu avec une version précise

# Ubuntu LTS actuelle (ex: 22.04)
limactl start --name=ubuntu-lts template://ubuntu-lts

# Ubuntu 20.04 (Focal Fossa) avec 2 CPU et 4 Go de RAM
limactl start --name=ubuntu20 template://ubuntu-20.04 --cpus=2 --memory=4G

# Ubuntu 22.04 (Jammy Jellyfish) en mode Virtualization.framework avec Rosetta
limactl start --name=ubuntu22 template://ubuntu-22.04 --vm-type=vz --rosetta

# Ubuntu 24.04 (Noble Numbat) : 4 CPU, 8 Go de RAM, Virtualization.framework, Rosetta, montage virtiofs en écriture
limactl start --name=ubuntu24 template://ubuntu-24.04 --cpus=4 --memory=8G --vm-type=vz --rosetta --mount-type=virtiofs --mount-writable

# Version non-LTS (ex: 24.10) ou future
limactl start --name=ubuntu-dev template://ubuntu-25.04

🛠️ Paramètres courants : - --cpus= : Nombre de CPU alloué à la VM. - --memory=G : Taille de la mémoire en Go (ex: 8G pour 8 Go). - --disk=G : Taille du disque en Go (par défaut 100Go). - --vm-type={qemu, vz} : Type de machine virtuelle (vz pour macOS Ventura+ utilisant Virtualization.framework, plus performant). - --rosetta : Active Rosetta pour l’exécution de binaires x86_64 sur Mac Apple Silicon (nécessite --vm-type=vz). - --mount-type={9p, virtiofs, reverse-sshfs} : Type de montage (performant : virtiofs avec vz). - --mount-writable : Donne accès en écriture au montage du répertoire de l’hôte.

🐚 Alternative interactive :

limactl start

➡️ Choisir le template dans l’interface interactive.

🖥️ Accéder à la VM

# Ouvre un shell interactif sur la VM nommée (commande raccourcie)
lima 

# Ou, pour une VM nommée "ubuntu24"
lima ubuntu24

# Commande standard
limactl shell 

# Exemple :
limactl shell ubuntu24

# Accès SSH avancé (pour scripts)
ssh -o IdentitiesOnly=yes -i ~/.lima/_config/user -p 60022 lima@127.0.0.1

🛑 Gérer la VM

limactl list                 # Lister toutes les VM
limactl stop         # Arrêter une VM
limactl start        # Démarrer une VM arrêtée
limactl restart      # Redémarrer une VM
limactl delete       # Supprimer une VM (demande confirmation)

⚠️ limactl delete supprime les disques et la configuration de la VM.

📂 Copier des fichiers entre hôte (Mac) et VM

lima cp <source> <destination>

Depuis le Mac vers la VM

limactl cp ./mon_fichier.txt ubuntu24:~/

Depuis la VM vers le Mac

limactl cp ubuntu24:~/rapport.pdf ./

Copier un répertoire récursivement

limactl cp -r  :

⚙️ Personnaliser la configuration de la VM

Editer la configuration post-création

limactl edit 

Exemple (fragment) :

cpus: 4
memory: "8GiB"
disk: "50GiB"
mounts:
  - location: "~"
    writable: true
    #virtiofs: true  # Utiliser pour vz si nécessaire

Après modification, arrêter et redémarrer la VM :

limactl stop 
limactl start 

Création avancée avec fichier de configuration YAML

1. Créez un fichier config.yaml avec le contenu souhaité :

images:
  - location: "https://cloud-images.ubuntu.com/releases/24.04/release/ubuntu-24.04-server-cloudimg-amd64.img"
    arch: "x86_64"
mounts:
  - location: "~"
    writable: true
cpus: 4
memory: "8GiB"
vmType: "vz"
rosetta: true
mountType: "virtiofs"

2. Lancez Lima en spécifiant le fichier de configuration :

limactl start --name=ubuntu24-advanced --file config.yaml

📝 Vérifier la version Ubuntu dans la VM

Une fois connecté à la VM :

lsb_release -a

Ou :

cat /etc/os-release

Commande depuis le Mac sans se connecter via un shell :

limactl shell ubuntu24 -- lsb_release -d

ℹ️ Infos rapides sur les images

• Source des images : Lima utilise les cloud-images Ubuntu au format QCOW2 (KVM/QEMU).
• Mises à jour : La première fois, l’image est téléchargée puis mise en cache.
• Non conteneur : Lima fonctionne avec des machines virtuelles complètes (QEMU ou Virtualization.framework), pas des conteneurs LXC.

💡 Astuces Lima + Ubuntu

• Hostname par défaut : lima-
• Utilisateur par défaut : lima (avec accès sudo sans mot de passe)
• Répertoire monté par défaut : Le répertoire home de l’utilisateur Mac est monté dans /mnt/lima/home/.
• Accès SSH avancé : Voir ~/.lima//ssh.config pour la configuration SSH complète.

🔗 Liens utiles

• Documentation officielle de Lima
• Liste des images cloud Ubuntu
• Github de Lima

Résumé workflow :
1. limactl start --name=... template://... (avec options)
2. limactl shell ... pour se connecter
3. Utiliser la VM comme un vrai système Ubuntu
4. limactl stop ... pour arrêter

Pro tips :
- Pour les Mac Apple Silicon : toujours privilégier --vm-type=vz et --rosetta.
- --mount-type=virtiofs offre les meilleures performances de partage de fichiers.
- Configurer les montages en écriture avec --mount-writable.