logo

live-bootstrap

Mirror of <https://github.com/fosslinux/live-bootstrap>

configurator (3472B)

    

  1. # SPDX-FileCopyrightText: 2024 fosslinux <fosslinux@aussies.space>
  2. #
  3. # SPDX-License-Identifier: GPL-3.0-or-later
  4. #
  5. # The structure of this file:
  6. # <option type> <id> <variable> <type> <default> <short description>
  7. # <long description>
  8. #
  9. # repeat
  11. m /general _ _ _ General configuration
  12. Settings for how you would like live-bootstrap to run.
  14. o /general/timestamps FORCE_TIMESTAMPS bool False Zero timestamps at end
  15. At the end of the bootstrap, set the timestamps of all files to 0 UNIX time.
  17. o /general/swap SWAP_SIZE size 0 Swap size
  18. The size of a swapfile to be created once swap is supported in live-bootsrap.
  19. Intended for systems with low RAM.
  21. o /general/kernel_bootstrap KERNEL_BOOTSTRAP bool True Use the kernel bootstrap
  22. This only applies if you are not in a chroot-like environment. You should
  23. already know whether you want this flag or not. If you booted using
  24. builder-hex0, this flag should be true; if you booted using your own Linux
  25. kernel, this flag should be false.
  27. o /general/interactive INTERACTIVE bool True Drop to a shell post-bootstrap
  28. At the end of the bootstrap, drop to a shell which you can do further things
  29. in.
  31. o /general/disk DISK "" _ [IMPORTANT] [DANGER] Disk
  32. live-bootstrap needs a disk which the final system will be installed onto.
  33. This should be in the form of the name of the device node, eg sda. If you
  34. have externally downloaded sources or the like, place in here the device
  35. node with the appropriate partition, eg sda1.
  36. Disclaimer for bare metal users:
  37. It is highly recommended that all disks other than this disk are removed
  38. from the system to avoid accidental data loss. It is vital that you choose
  39. this correctly, otherwise you risk overwriting an existing disk on your
  40. system. LIVE-BOOTSTRAP TAKES NO LIABILITY FOR ANY DATA LOSS RESULTING FROM
  41. ITS USE.
  43. m /sysinfo _ _ _ System information
  44. Details about your specific system and the environment live-bootstrap is
  45. running in.
  47. o /sysinfo/chroot CHROOT bool False Chroot-like environment
  48. Only set to True if live-bootstrap is running in a chroot-like environment.
  49. This might be in a chroot, on bubblewrap, or similar. QEMU is not a
  50. chroot-like environment.
  52. o /sysinfo/baremetal BARE_METAL bool False Bare metal environment
  53. Only set to True if live-bootstrap is running directly on bare metal, without
  54. another kernel or virtualisation layer in between. A chroot, bubblewrap, or
  55. QEMU is not bare metal.
  57. o /sysinfo/jobs FINAL_JOBS int _ Number of jobs
  58. The number of jobs that packages should be compiled with. A sensible value
  59. would be the number of threads on your system.
  61. o /sysinfo/arch ARCH "x86|amd64|riscv64" _ Architecture
  62. The architecture live-bootstrap is running on.
  64. m /sysinfo/internal _ _ _ [INTERNAL] Advanced configuration
  65. Internal configuration. You should not touch this unless you know what you
  66. are doing!
  68. o /sysinfo/internal/ci INTERNAL_CI bool False Internal CI
  69. If you are seeing this, it should not be set to true. (Flag for live-bootstrap
  70. CI).
  72. m /dev _ _ _ [DEV] Development options
  73. Options intended for primarily live-bootstrap development or debugging.
  75. o /dev/update_checksums UPDATE_CHECKSUMS bool False [DEV] Update checksums of packages
  76. Rather than checking checksums of packages against the existing list, generate
  77. a new list for the checksums of packages.
  79. o /dev/build_kernels BUILD_KERNELS bool _ Build kernels
  80. Even when they are not required, still build kernels/kernel adjacent packages.
  81. This option has no effect when using KERNEL_BOOTSTRAP.