[Request] Add more info about images into Getting Started

While I was searching for vm images, I noticed that the “Getting started” docs maybe lack some info about the use of images.
Maybe some information could be added to it?

Some info I find useful:

  1. Regarding the use the implemented remote image-servers:
  • List of image-servers:
    lxc remote list

  • show remote images:
    lxc image list images:

  • explain differences between:

    • virtual machine
    • container
    • default
    • cloud
  • explain how to specify the search.
    For example:
    lxc image list images: debian
    will show all debian images

  • explain how to use the listed images

  1. Regarding the manual download of images:
    Note: Maybe a topic for a seperate Images-doc.
    But could be linked inside the “Getting started”-doc.

Usecase: This is sometimes useful if someone wants to change something beforehand, e.g. modify the qcow image of the vm.


  • normal container image:


lxc image import lxd.tar.xz rootfs.squashfs --alias custom-imagename

  • vm-image:


lxc image import lxd.tar.xz disk.qcow2 --alias custom-imagename

  1. Regarding Building your own Images:
    Note: Maybe also a topic for a seperate Images-doc .
    But could be linked inside the “Getting started”-doc.

Image templates:


Thanks for the suggestions.

Did you find the answers you needed or are you needing clarification on any particular point?

If you feel confident enough with it and had the time, if you write a forum post about image management we could move it into the Tutorials section for others to benefit from in the future.

Also, the getting started guide source is on github here , if you were able to make a pull request with suggested changes then this could be review by one of the team.

1 Like

Found most of the answers :slight_smile:.

One question:
I haven’t tried it yet, but I assume distrobuilder can also build vm images?

Thanks for the tip.
I will try that :slight_smile:.

Some questions about writing:

  • Just for security: The Docs are written in Markdown?
  • Can I add a page for “Images”?
    Update: I see that the “docs”, (for example: Requirements), are in the program repos (https://github.com/lxc/lxd/tree/master/doc).
    Can I also contribute to those, or wouldn’t you like that?
  • Could I write a little info about how to edit a qcow-image or wouldn’t you like to see that?


  • Am I correct that I only need to add:
Signed-off-by: Random J Developer <random@developer.org>

to my commits?
Hmm :thinking: I like my privacy, but maybe I can make an exception for you.

Yep, that’s right. The DCO is pretty common, mostly being popularized by the Linux Kernel when they ran into some legal issues a long time ago where just the automatic Author field didn’t quite satisfy some legal folks about who owns copyright on a particular change.

:smile: Yeah the usual legal stuff, it does stop at nothing.

I will see what I can do about it, maybe I use one of my “public” domains.

  • One more thing: Do you want pull requests in small pieces?
    Or can I also send a bigger pull request and you choose which commits you want to have (if any)?

Probably smaller PRs would suit best that way they are easier to review. Thanks.