xoxys.users/index.md
Robert Kaussow 158b0cd26d commit fa786ded90
Author: Robert Kaussow <mail@thegeeklab.de>
Date:   Mon Sep 12 16:30:16 2022 +0200

    fix documentation
2022-09-12 14:33:13 +00:00

94 lines
1.7 KiB
Markdown

---
title: users
type: docs
---
[![Source Code](https://img.shields.io/badge/gitea-source%20code-blue?logo=gitea&logoColor=white)](https://gitea.rknet.org/ansible/xoxys.users) [![Build Status](https://img.shields.io/drone/build/ansible/xoxys.users?logo=drone&server=https%3A%2F%2Fdrone.rknet.org)](https://drone.rknet.org/ansible/xoxys.users) [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://gitea.rknet.org/ansible/xoxys.users/src/branch/main/LICENSE)
Manage users and default bash environment.
<!--more-->
- [Default Variables](#default-variables)
- [users_bash_bashrc_overrides](#users_bash_bashrc_overrides)
- [users_default_groups](#users_default_groups)
- [users_default_umask](#users_default_umask)
- [users_default_users](#users_default_users)
- [users_global_bash_aliases](#users_global_bash_aliases)
- [Dependencies](#dependencies)
---
## Default Variables
### users_bash_bashrc_overrides
#### Default value
```YAML
users_bash_bashrc_overrides: []
```
#### Example usage
```YAML
users_bash_bashrc_overrides:
- /etc/skel/.bashrc
- /root/.bashrc
```
### users_default_groups
#### Default value
```YAML
users_default_groups: []
```
### users_default_umask
#### Default value
```YAML
users_default_umask: '022'
```
### users_default_users
#### Default value
```YAML
users_default_users: []
```
#### Example usage
```YAML
users_default_users:
- name: admin
groups:
- wheel
password: "secure"
sshkeys: |
"ssh-ed25519 AAAA..."
shell: /bin/bash
```
### users_global_bash_aliases
#### Default value
```YAML
users_global_bash_aliases:
- alias: ll
command: ls -lh
- alias: la
command: ls -lha
```
## Dependencies
None.