---
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)](LICENSE) 

Manage users and default bash environment.

* [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"
    key: "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.