Documentation

doas – Do As user

New in version 2.8.

Synopsis

  • This become plugins allows your remote/login user to execute commands as another user via the doas utility.

Parameters

Parameter Choices/Defaults Configuration Comments
become_exe
-
Default:
"doas"
ini entries:

[privilege_escalation]
become_exe = doas

[doas_become_plugin]
executable = doas

env:ANSIBLE_BECOME_EXE
env:ANSIBLE_DOAS_EXE
var: ansible_become_exe
var: ansible_doas_exe
Doas executable
become_flags
-
Default:
null
ini entries:

[privilege_escalation]
become_flags = None

[doas_become_plugin]
flags = None

env:ANSIBLE_BECOME_FLAGS
env:ANSIBLE_DOAS_FLAGS
var: ansible_become_flags
var: ansible_doas_flags
Options to pass to doas
become_pass
-
ini entries:

[doas_become_plugin]
password = VALUE

env:ANSIBLE_BECOME_PASS
env:ANSIBLE_DOAS_PASS
var: ansible_become_password
var: ansible_become_pass
var: ansible_doas_pass
password for doas prompt
become_user
-
ini entries:

[privilege_escalation]
become_user = VALUE

[doas_become_plugin]
user = VALUE

env:ANSIBLE_BECOME_USER
env:ANSIBLE_DOAS_USER
var: ansible_become_user
var: ansible_doas_user
User you 'become' to execute the task
prompt_l10n
-
Default:
[]
ini entries:

[doas_become_plugin]
localized_prompts = []

env:ANSIBLE_DOAS_PROMPT_L10N
var: ansible_doas_prompt_l10n
List of localized strings to match for prompt detection
If empty we'll use the built in one

Status

Authors

  • ansible (@core)

Hint

If you notice any issues in this documentation you can edit this document to improve it.