From 573ebdfd4469a1ccdf60aa68dbdb9f8af8b77586 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?St=C3=A9phane=20Graber?= Date: Wed, 19 Nov 2025 01:16:34 -0500 Subject: [PATCH] doc/contributing: Document the use of the debug application MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Stéphane Graber --- doc/contributing.md | 10 +++------- 1 file changed, 3 insertions(+), 7 deletions(-) diff --git a/doc/contributing.md b/doc/contributing.md index 03ff32e..6fe058d 100644 --- a/doc/contributing.md +++ b/doc/contributing.md @@ -53,11 +53,7 @@ Then `exec` into the virtual machine, stop the main `incus-osd` service and run mount -o bind /root/incus-osd /usr/local/bin/incus-osd systemctl start incus-osd -There's no text editor in the base image, but it's easy to fetch the [micro](https://github.com/zyedidia/micro) text editor: +When debugging, it's a good idea to install the `debug` application which contains a variety of useful tools, including a basic text editor (`nano`). - mkdir /tmp/micro/ - curl -sLo /tmp/micro/micro.tar.gz https://github.com/zyedidia/micro/releases/download/v2.0.14/micro-2.0.14-linux64-static.tar.gz - tar -xzf /tmp/micro/micro.tar.gz -C /tmp/micro --strip-components=1 - mv /tmp/micro/micro /root/micro - rm -rf /tmp/micro - export EDITOR=/root/micro + incus exec test-incus-os bash + curl --unix-socket /run/incus-os/unix.socket socket/1.0/applications -X POST -d '{"name": "debug"}'