VIP - Verified Installation of Posit

An open-source, extensible test suite that validates Posit Team deployments are installed correctly and functioning properly.

VIP uses BDD-style tests (pytest-bdd + Playwright) to verify Connect, Workbench, and Package Manager across standalone, Kubernetes, and Snowflake Native App deployments. Results are compiled into an HTML report that can be published to a Connect server.

Documentation: https://posit-dev.github.io/vip/

Quick start

uv venv
source .venv/bin/activate
uv pip install posit-vip
uv run vip install
vip verify --connect-url https://connect.example.com --interactive-auth

On a headless server (no display), use --headless-auth instead:

vip verify --config vip.toml --headless-auth

Run a specific test by name:

vip verify --connect-url https://connect.example.com --filter test_login

With a configuration file:

cp vip.toml.example vip.toml     # edit with your deployment details
vip verify --config vip.toml

Uninstalling

To reverse what vip install (or just setup) did:

uv run vip uninstall        # dry run; prints the full plan including any sudo command
uv run vip uninstall --yes  # remove Playwright cache + manifest; prints the sudo command
                            # for any system packages so you can remove them yourself

vip uninstall only removes packages and files that vip install recorded in .vip-install.json; anything that was already on your machine before running vip install is left alone.

If a Connect URL is configured (in vip.toml or via --connect-url), vip uninstall chains vip cleanup first to remove _vip_test-tagged content from Connect.

CLI commands

Command	Description
vip verify	Run verification tests against a Posit Team deployment
vip status	Quick health check for each configured product
vip cleanup	Delete VIP _vip_test content from Connect
vip report	Render the HTML report from test results (requires Quarto CLI)
vip auth	Authentication tools (e.g. mint Connect API keys)

Run vip --help or vip <command> --help for full usage details.

Development

See docs/development.md for dev setup, linting, and formatting.

For the test architecture and four-layer design, see docs/test-architecture.md.

License

MIT — see LICENSE.