From 735bd62f40ec5431b60104bf55dd89d817ac40b6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?St=C3=A9phane=20Graber?= <stgraber@stgraber.org>
Date: Tue, 22 Oct 2024 18:05:59 -0400
Subject: [PATCH] doc/howto/instances_create: Add an example of application
 container
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Signed-off-by: Stéphane Graber <stgraber@stgraber.org>
---
 doc/howto/instances_create.md | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/doc/howto/instances_create.md b/doc/howto/instances_create.md
index 5b99eeb4268..f6fd3e3c2e4 100644
--- a/doc/howto/instances_create.md
+++ b/doc/howto/instances_create.md
@@ -48,12 +48,22 @@ Check the contents of an existing instance configuration ([`incus config show <i
 
 The following examples use [`incus launch`](incus_launch.md), but you can use [`incus init`](incus_create.md) in the same way.
 
-### Launch a container
+### Launch a system container
 
-To launch a container with an Ubuntu 22.04 image from the `images` server using the instance name `ubuntu-container`, enter the following command:
+To launch a system container with an Ubuntu 22.04 image from the `images` server using the instance name `ubuntu-container`, enter the following command:
 
     incus launch images:ubuntu/22.04 ubuntu-container
 
+### Launch an application container
+
+To launch an application (OCI) container, you first need to add an image registry:
+
+    incus remote add oci-docker https://docker.io --protocol=oci
+
+And then can launch a container from one of its images:
+
+    incus launch oci-docker:hello-world --ephemeral --console
+
 ### Launch a virtual machine
 
 To launch a virtual machine with an Ubuntu 22.04 image from the `images` server using the instance name `ubuntu-vm`, enter the following command: