174 lines
5.1 KiB
Plaintext
174 lines
5.1 KiB
Plaintext
# SPDX-FileCopyrightText: no
|
|
# SPDX-License-Identifier: CC0-1.0
|
|
#
|
|
# Commented out values are defaults.
|
|
# All commands are running with 'sh -c'.
|
|
---
|
|
# This entry exists only to keep the tests happy, remove it in
|
|
# any production configuration.
|
|
bogus: true
|
|
|
|
#######
|
|
### Target OS information
|
|
#######
|
|
|
|
## Operating System Name
|
|
# osName: "(unknown)"
|
|
|
|
## User Interface name (e.g. Plasma Mobile)
|
|
# userInterface: "(unknown)"
|
|
|
|
## User Interface assumes that the password is numeric (as of writing, this is
|
|
## the case with Plasma Mobile and Phosh)
|
|
# userPasswordNumeric: true
|
|
|
|
## OS version
|
|
# version: "(unknown)"
|
|
|
|
## Default username (for which the password will be set)
|
|
## Ensure also cmdUsermod command matches the default user, so it can be changed if desired.
|
|
# username: "user"
|
|
|
|
## reserved usernames (for user_pass username prompt and ssh_credentials)
|
|
# reservedUsernames:
|
|
# - adm
|
|
# - at
|
|
# - bin
|
|
# - colord
|
|
# - cron
|
|
# - cyrus
|
|
# - daemon
|
|
# - ftp
|
|
# - games
|
|
# - geoclue
|
|
# - guest
|
|
# - halt
|
|
# - lightdm
|
|
# - lp
|
|
# - mail
|
|
# - man
|
|
# - messagebus
|
|
# - news
|
|
# - nobody
|
|
# - ntp
|
|
# - operator
|
|
# - polkitd
|
|
# - postmaster
|
|
# - pulse
|
|
# - root
|
|
# - shutdown
|
|
# - smmsp
|
|
# - squid
|
|
# - sshd
|
|
# - sync
|
|
# - uucp
|
|
# - vpopmail
|
|
# - xfs
|
|
|
|
#######
|
|
### Target device information
|
|
#######
|
|
|
|
## Architecture (e.g. aarch64)
|
|
# arch: "(unknown)"
|
|
|
|
## Name of the device (e.g. PinePhone)
|
|
# device: "(unknown)"
|
|
|
|
## Partition that will be formatted and mounted (optionally with FDE) for the
|
|
## rootfs
|
|
# targetDeviceRoot: "/dev/unknown"
|
|
|
|
## Partition that will be formatted and mounted (optionally with FDE) for the
|
|
## rootfs, on internal storage. The installer OS must not set this, if it was
|
|
## booted from the internal storage (this is not checked in the mobile
|
|
## module!).
|
|
## If this is set, the user gets asked whether they want to install on internal
|
|
## or external storage. If the user chose internal storage,
|
|
## cmdInternalStoragePrepare (see below) runs before this partition gets
|
|
## formatted (see below). A note is displayed, that the device is powered off
|
|
## after installation and that the user should remove the external storage
|
|
## medium. So you need to adjust the installer OS to poweroff in that case, and
|
|
## not reboot. See postmarketos-ondev.git for reference.
|
|
# targetDeviceRootInternal: ""
|
|
|
|
######
|
|
### Installer Features
|
|
######
|
|
|
|
## Ask whether sshd should be enabled or not. If enabled, add a dedicated ssh
|
|
## user with proper username and password and suggest to change to key-based
|
|
## authentication after installation.
|
|
# featureSshd: true
|
|
|
|
## Ask the user, which filesystem to use.
|
|
# featureFsType: false
|
|
## Filesystems that the user can choose from.
|
|
#fsModel:
|
|
# - ext4
|
|
# - f2fs
|
|
# - btrfs
|
|
## Default filesystem to display in the dialog. If featureFsType is disabled,
|
|
## this gets used without asking the user.
|
|
# defaultFs: ext4
|
|
|
|
## Start Qt's virtual keyboard within the mobile module. Disable if you bring
|
|
## your own virtual keyboard (e.g. svkbd).
|
|
# builtinVirtualKeyboard: true
|
|
|
|
#######
|
|
### Commands running in the installer OS
|
|
#######
|
|
|
|
## Format the target partition with LUKS
|
|
## Arguments: <device>
|
|
## Stdin: password with \n
|
|
# cmdLuksFormat: "cryptsetup luksFormat --use-random"
|
|
|
|
## Open the formatted partition
|
|
## Arguments: <device> <mapping name>
|
|
## Stdin: password with \n
|
|
# cmdLuksOpen: "cryptsetup luksOpen"
|
|
|
|
## Format the rootfs with a file system
|
|
## Arguments: <device>
|
|
## Btrfs: to allow snapshots to work on the root subvolume, it is recommended that this
|
|
## command be a script which will create a subvolume and make it default
|
|
## An example can be found at:
|
|
## https://gitlab.com/mobian1/calamares-settings-mobian/-/merge_requests/2/diffs#diff-content-dde34f5f1c89e3dea63608c553bbc452dedf428f
|
|
# cmdMkfsRootBtrfs: "mkfs.btrfs -L 'unknownOS_root'"
|
|
# cmdMkfsRootExt4: "mkfs.ext4 -L 'unknownOS_root'"
|
|
# cmdMkfsRootF2fs: "mkfs.f2fs -l 'unknownOS_root'"
|
|
|
|
## Mount the partition after formatting with file system
|
|
## Arguments: <device> <mountpoint>
|
|
# cmdMount: "mount"
|
|
|
|
## When user selects installation from external storage to internal storage
|
|
## (see targetDeviceRootInternal above), use this command to prepare the
|
|
## internal storage medium. The command must create a partition table with
|
|
## two partitions (boot, root) and fill the boot partition. See the
|
|
## ondev-internal-storage-prepare.sh in postmarketos-ondev as example.
|
|
# cmdInternalStoragePrepare: "ondev-internal-storage-prepare"
|
|
|
|
#######
|
|
### Commands running in the target OS (chroot)
|
|
#######
|
|
|
|
## Change the username for the default user
|
|
## Stdin: username with \n
|
|
# cmdUsermod: "xargs -I{} -n1 usermod -m -d /home/{} -l {} -c {} user"
|
|
|
|
## Set the password for default user and sshd user
|
|
## Arguments: <username>
|
|
## Stdin: password twice, each time with \n
|
|
# cmdPasswd: "passwd"
|
|
|
|
## Enable or disable sshd
|
|
# cmdSshdEnable: "systemctl enable sshd.service"
|
|
# cmdSshdDisable: "systemctl disable sshd.service"
|
|
|
|
## Create the user for sshd
|
|
## Arguments: <username>
|
|
# cmdSshdUseradd: "useradd -G wheel -m"
|