• Stars
    star
    320
  • Rank 131,126 (Top 3 %)
  • Language
    Shell
  • License
    Other
  • Created over 6 years ago
  • Updated 4 months ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

The Void Linux live image maker

The Void Linux image/live/rootfs maker and installer

This repository contains utilities for Void Linux:

  • installer (The Void Linux el-cheapo installer for x86)

  • mklive (The Void Linux live image maker for x86)

  • mkimage (The Void Linux image maker for ARM platforms)

  • mkplatformfs (The Void Linux filesystem tool to produce a rootfs for a particular platform)

  • mkrootfs (The Void Linux rootfs maker for ARM platforms)

  • mknet (Script to generate netboot tarballs for Void)

Dependencies

  • Compression type for the initramfs image
    • liblz4 (for lz4, xz) (default)
  • xbps>=0.45
  • qemu-user-static binaries (for mkrootfs)
  • bash

Usage

See the usage output:

$ ./mklive.sh -h
$ ./mkrootfs.sh -h
$ ./mkimage.sh -h

Examples

Build a native live image keyboard set to 'fr':

# ./mklive.sh -k fr

Build an i686 (on x86_64) live image with some additional packages:

# ./mklive.sh -a i686 -p 'vim rtorrent'

Build an x86_64 musl live image with packages stored in a local repository:

# ./mklive.sh -a x86_64-musl -r /path/to/host/binpkgs

See the usage output for more information :-)

Kernel Command-line Parameters

void-mklive-based live images support several kernel command-line arguments that can change the behavior of the live system:

  • live.autologin will skip the initial login screen on tty1.
  • live.user will change the username of the non-root user from the default anon. The password remains voidlinux.
  • live.shell sets the default shell for the non-root user in the live environment.
  • live.accessibility enables accessibility features like the console screenreader espeakup in the live environment.
  • console can be set to ttyS0, hvc0, or hvsi0 to enable agetty on that serial console.
  • locale.LANG will set the LANG environment variable. Defaults to en_US.UTF-8.
  • vconsole.keymap will set the console keymap. Defaults to us.

Examples:

  • live.autologin live.user=foo live.shell=/bin/bash would create the user foo with the default shell /bin/bash on boot, and log them in automatically on tty1
  • live.shell=/bin/bash would set the default shell for the anon user to /bin/bash
  • console=ttyS0 vconsole.keymap=cf would enable ttyS0 and set the keymap in the console to cf
  • locale.LANG=fr_CA.UTF-8 would set the live system's language to fr_CA.UTF-8

More Repositories

1

void-packages

The Void source packages collection
Shell
2,505
star
2

xbps

The X Binary Package System (XBPS)
C
786
star
3

void-runit

runit init scripts for Void
C
173
star
4

runit

The init system for Void Linux.
C
162
star
5

void-docs

mdbook source for docs.voidlinux.org
CSS
160
star
6

void-containers

OCI container images for Void Linux
Dockerfile
68
star
7

void-infrastructure

Infrastructure configuration data for Void systems
HCL
63
star
8

void-linux.github.io

Void Linux website
CSS
63
star
9

musl-fts

Implementation of fts(3) for musl libc packages in Void Linux
C
34
star
10

void-updates

Update check system for void-packages
Shell
30
star
11

musl-obstack

A standalone library to implement GNU libc's obstack
C
19
star
12

netbsd-wtf

NetBSD's wtf(6) adapted for Void Linux
Roff
17
star
13

void-installer

Not the repo you're looking for. Look at mklive instead.
Shell
17
star
14

xmirror

Interactive script for changing XBPS mirrors
Shell
17
star
15

void-wiki

Components for wiki.voidlinux.org
PHP
12
star
16

libglob

BSD glob(3) implementation with non-POSIX features
C
11
star
17

xmandump

Dump all manpages in an XBPS package for use with man.cgi
Go
8
star
18

documentation

Void Linux documentation
8
star
19

socklog-void

SockLog configuration for Void Linux
Shell
7
star
20

ircbot

Void's IRC Notification Bot
Go
5
star
21

openbsd-man

The OpenBSD man(1) utility for Linux
C
5
star
22

repo-exporter

Prometheus exporter for XBPS Repos
Go
4
star
23

buildbot-config

obsoleted by void-infrastructure
Python
3
star
24

void-texlive

Components for packaging TeX into XBPS
Shell
3
star
25

jbigkit-shared

Autotools and libtool for JBIG-KIT version 2.1
C
2
star
26

xbps-legacy-sign

Sign xbps packages using xbps's quirks for backwards compatibility.
Go
2
star
27

man-site

Components related to man.voidlinux.org
Shell
2
star
28

portableproplib

Portable Property container object library
C
1
star