For community users, you are reading an unmaintained version of the Ansible documentation. Unmaintained Ansible versions can contain unfixed security vulnerabilities (CVE). Please upgrade to a maintained version. See the latest Ansible community documentation . For Red Hat customers, see the Red Hat AAP platform lifecycle.

doas – Do As user¶

New in version 2.8.

Synopsis
Parameters
Status

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 -		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 ¶

This become is not guaranteed to have a backwards compatible interface. [preview]
This become is maintained by the Ansible Community. [community]

Authors¶

ansible (@core)

Hint

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

Hint

Configuration entries for each entry type have a low to high priority order. For example, a variable that is lower in the list will override a variable that is higher up.