diff --git a/pages/linux/homectl.md b/pages/linux/homectl.md new file mode 100644 index 0000000000..c4d6cb4b23 --- /dev/null +++ b/pages/linux/homectl.md @@ -0,0 +1,36 @@ +# homectl + +> Create, remove, change or inspect home directories using the systemd-homed service. +> More information: . + +- List user accounts and their associated home directories: + +`homectl list` + +- Create a user account and their associated home directory: + +`sudo homectl create {{username}}` + +- Remove a specific user and the associated home directory: + +`sudo homectl remove {{username}}` + +- Change the password for a specific user: + +`sudo homectl passwd {{username}}` + +- Run a shell or a command with access to a specific home directory: + +`sudo homectl with {{username}} -- {{command}} {{command_arguments}}` + +- Lock or unlock a specific home directory: + +`sudo homectl {{lock|unlock}} {{username}}` + +- Change the disk space assigned to a specific home directory to 100 GiB: + +`sudo homectl resize {{username}} {{100G}}` + +- Display help: + +`homectl --help`