---
name: "cdist-type__package_dpkg"
section: "7"
platform: "linux"
package: "cdist"
version: "7.0.0-5"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/cdist-type__package_dpkg"
---

# cdist-type\_\_package\_dpkg(7)

Manage packages with dpkg

## NAME

cdist-type\_\_package\_dpkg - Manage packages with dpkg

## DESCRIPTION

This type is used on Debian and variants (like Ubuntu) to install packages that are provided locally as \*.deb files.

The object given to this type must be the name of the deb package. The filename of the deb package has to follow Debian naming conventions, i.e. *${binary:Package}\_${Version}\_${Architecture}.deb* (see *[dpkg-query(1)](/dpkg-query/1.md)* for details).

## OPTIONAL PARAMETERS

- **state**

  *present* or *absent*, defaults to *present*.

## REQUIRED PARAMETERS

- **source**

  path to the \*.deb package

## BOOLEAN PARAMETERS

- **purge-if-absent**

  If this parameter is given when state is *absent*, the package is purged from the system (using *--purge*).

## EXPLORER

- **pkg\_state**

  Returns the full package name if package is installed, empty otherwise.

## MESSAGES

- **installed**

  The deb-file was installed.

- **removed (--remove)**

  The package was removed, keeping config.

- **removed (--purge)**

  The package was removed including config (purged).

## EXAMPLES

```
# Install foo and bar packages
__package_dpkg foo_0.1_all.deb --source /tmp/foo_0.1_all.deb
__package_dpkg bar_1.4.deb --source $__type/files/bar_1.4.deb
# uninstall baz:
__package_dpkg baz_1.4_amd64.deb \
    --source $__type/files/baz_1.4_amd64.deb \
    --state "absent"
# uninstall baz and also purge config-files:
__package_dpkg baz_1.4_amd64.deb \
    --source $__type/files/baz_1.4_amd64.deb \
    --purge-if-absent \
    --state "absent"
```

## SEE ALSO

[**cdist-type\_\_package**(7)](/cdist-type__package/7.md), [**dpkg-query**(1)](/dpkg-query/1.md)

## AUTHORS

```
Tomas Pospisek <tpo_deb--@--sourcepole.ch>
Thomas Eckert <tom--@--it-eckert.de>
```

## COPYING

Copyright (C) 2013 Tomas Pospisek. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This type is based on \_\_package\_apt.

## COPYRIGHT

ungleich GmbH 2021