User Tools

  • (equal to forum credentials)

Site Tools


Creating a Clean Image

If you want to create an official XBian image we can use for distribution, follow these steps:

  • Flash the latest XBian image.
  • Boot.
  • Stop xbmc and use the terminal or connect to XBian through SSH (stopping xbmc will speed up the process anyway).
  • Upgrade all package as they appear in the stable repository.
  • Reboot
  • Run

root@xbian:~# all-clean

This command will remove garbage like cached debs for apt, logs, xbian & root histories, it will reset XBMC settings, removes ssh keys (they will be regenerated upon next boot) etc. This will make the clean image even cleaner.

  • Clone to an image file with xbian-config (option 6). Use the file:/media/usbX/file.img as the destination path. Make sure you use a usb stick here so no mountpoints are copied inside the image.
  • Done. Put the image somewhere online so we can use it.


This auto process will try to guess the minimum possible size for the destination image file. Unfortunately this leads to a new rootfs (and image) of about ~600mb. This will force btrfs to use mixed-data-metadata structure (because the filesystem is too small). According to the documentation of BTRFS, such a filesystem (even after resize) will keep this structure, which can lead to performance hits. The documentation isn't very specific about what they consider a small or big filesystem and what the actual performance hit is. Probably, it won't make any difference on the SD cards we use.

Personal usage

If you want to create an image for your personal use only, then you of course already flashed the image and upgraded it. In that case skip the flash and all-clean step.

create_image.txt · Last modified: 2014/06/03 16:10 by curlymo