# salt.states.virtualenv

## Setup of Python virtualenv sandboxes.

`salt.states.virtualenv_mod.` `managed`(name, venv_bin='virtualenv', requirements=None, no_site_packages=None, system_site_packages=False, distribute=False, use_wheel=False, clear=False, python=None, extra_search_dir=None, never_download=None, prompt=None, user=None, runas=None, no_chown=False, cwd=None, index_url=None, extra_index_url=None, pre_releases=False)

  Create a virtualenv and optionally manage it with pip

  name
    Path to the virtualenv
  requirements
    Path to a pip requirements file. If the path begins with `salt://` the file will be transferred from the master file server.
  cwd
    Path to the working directory where "pip install" is executed.
  use_wheel : False
    Prefer wheel archives (requires pip>=1.4)

  Also accepts any kwargs that the virtualenv module will.

      /var/www/myvirtualenv.com:
        virtualenv.managed:
          - system_site_packages: False
          - requirements: salt://REQUIREMENTS.txt

Current Salt release: 0.17.1

### Table Of Contents

- salt.states.virtualenv
  - Setup of Python virtualenv sandboxes.

#### Previous topic

salt.states.user

#### Next topic

salt.states.win_dns_client

### Quick search

Enter search terms or a module, class or function name.

### Upcoming SaltStack Events

My conferences on Lanyrd