Go to file
Raphaël Hertzog cf122d1bd6 Create a system usergroup if user is a system user
If the user to be created is a system user, it makes no sense to create
him a primary group which is not a system group too.
2016-06-22 12:08:39 +02:00
users Create a system usergroup if user is a system user 2016-06-22 12:08:39 +02:00
LICENSE Removing extra new line characters 2015-05-07 13:39:04 -04:00
README.rst Added feature to allow syncing arbitrary sets of files per user. 2015-08-21 15:42:25 -05:00
pillar.example Resolve `git.config` error where minion does not have Git installed #115 2016-06-09 09:13:32 +01:00

README.rst

=====
users
=====

Formula to configure users via pillar.


.. note::

    See the full `Salt Formulas installation and usage instructions
    <http://docs.saltstack.com/topics/development/conventions/formulas.html>`_.

Available states
================

.. contents::
    :local:

``users``
---------

Configure a user's home directory, group, the user itself, secondary groups,
and associated keys. Also configures sudo access, and absent users.

``users.sudo``
--------------

Ensures the sudo group exists, the sudo package is installed and the sudo file
is configured.

``users.bashrc``
----------------

Ensures the bashrc file exists in the users home directory. Set manage_bashrc:
True in pillar per user. Defaults to False

``users.profile``
----------------

Ensures the profile file exists in the users home directory. Set manage_profile:
True in pillar per user. Defaults to False

``users.vimrc``
---------------

Ensures the vimrc file exists in the users home directory. Set manage_vimrc:
True in pillar per user. Defaults to False
This depends on the vim-formula to be installed

``users.user_files``
---------------

Permits the abitrary management of files. See pillar.example for configuration details.