XT-INSTALL-IMAGE(8)

📦
version 4.9.2 · 4 versions
, in debian bookworm, ubuntu noble

💖 xt-install-image(8) — the girlies' guide 💖

okay so bestie, welcome to xt-install-image, from the Perl Programmers Reference Guide section 8 (that's the sysadmin one, very demure, very mindful). this little icon drops a fresh copy of GNU/Linux into a directory and it's literally the moment before everything gets cute. 🦋

✨ SYNOPSIS ✨

  xt-install-image [options]

  Help Options:
   --help           Show this scripts help information.
   --manual         Read this scripts manual.
   --version        Show the version number and exit.

  Debugging Options:
   --verbose        Be verbose in our execution.

  Mandatory Options:
   --location       The location to use for the new installation
   --dist           The name of the distribution which has been installed.

  Misc Options:
   --arch           Pass the given arch setting to debootstrap or rpmstrap.
   --config         Read the specified config file in addition to the global
                    configuration file.
   --mirror         The mirror to use when installing with 'debootstrap'.
   --apt_proxy      The proxy to use when installing with 'debootstrap'.
   --keyring        The keyring to use when installing with 'debootstrap'.

  Installation Options:
   --install-method  Specify the installation method to use.
   --install-source  Specify the installation source to use.
   --debootstrap-cmd Specify which debootstrap command to
                     use. Defaults to debootstrap if both, debootstrap
                     and cdebootstrap are installed.

  All other options from xen-create-image will be passed as environmental
 variables.

🎀 OPTIONS 🎀

🫶 Help Options

  • --help — shows you this script's help info. your emotional support text, fr.
  • --manual — reads you this script's manual. it's giving bedtime story but for sysadmins.
  • --version — prints the version number and dips. 👋

🐛 Debugging Options

  • --verbose — be verbose in our execution. she talks. a lot. 💅

👑 Mandatory Options

these are not optional, bestie. you need them or nothing happens.

  • --location — the location to use for the new installation. that's where the whole new distro moves in, main character apartment energy.
  • --dist — the name of the distribution which has been installed.

🌸 Misc Options

  • --arch — pass the given arch setting to debootstrap or rpmstrap.
  • --config — read the specified config file in addition to the global configuration file. yes, both. she's greedy, and honestly? valid.
  • --mirror — the mirror to use when installing with 'debootstrap'.
  • --apt_proxy — the proxy to use when installing with 'debootstrap'.
  • --keyring — the keyring to use when installing with 'debootstrap'.

🧚 Installation Options

  • --install-method — specify the installation method to use.
  • --install-source — specify the installation source to use.
  • --debootstrap-cmd — specify which debootstrap command to use. defaults to debootstrap if both, debootstrap and cdebootstrap are installed.
✨ and here's the spicy part: all other options from xen-create-image will be passed as environmental variables. no cap. so if you don't see your fave flag here, she's out there living as an env var. 🌈

📝 NOTES 📝

this script is invoked by xen-create-image after, to create a new distribution of Linux. once the script has been created, the companion script xt-customize-image will be invoked to perform the network configuration, etc. so it's a whole relay race of scripts and they're all passing the baton beautifully. 🏃♀️💨

🌟 INSTALLATION METHODS 🌟

there are several available methods of installation, depending upon the user's choice. only one option may be chosen at any given time. pick one. just one. she's monogamous. 💀

the methods available are:

  • debootstrap — install the distribution specified by the --dist argument using the debootstrap. if you use this option you must specify a mirror with --mirror. mandatory mirror, no exceptions, she will not start without it. 🪞
  • copy — copy the given directory recursively. this local directory is assumed to contain a complete installation. specify the directory to copy with the --install-source argument.
  • rinse — install the distribution specified by --dist using the rinse command.
  • rpmstrap — install the distribution specified by --dist using the rpmstrap command.
  • tar — untar a .tar file into the new installation location. this tarfile is assumed to contain a complete archived system. specify the directory to copy with the --install-source argument.

👑 AUTHORS 👑

the legends themselves. bow. 🙇♀️

📜 LICENSE 📜

Copyright (c) 2005-2009 by Steve Kemp, (c) 2010 by The Xen-Tools Development Team. All rights reserved.

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. The LICENSE file contains the full text of the license.

and that's the whole page, bestie!! this one is version 4.9.2, dated 2023-02-06, and it lives in the xt-install-image(8) manual. go forth and install a whole entire GNU/Linux into a directory, you absolute icon. mwah. 💖✨🎀🦋

📦 where this page comes from