---
name: "pkgctl-version"
section: "1"
platform: "linux"
package: "devtools"
version: "1:1.5.3-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/pkgctl-version"
---

# pkgctl-version(1)

Check and manage package versions against upstream

## NAME

pkgctl-version - Check and manage package versions against upstream

## SYNOPSIS

pkgctl version \[OPTIONS\] \[SUBCOMMAND\]

## DESCRIPTION

Commands related to package versions, including checks for outdated packages.

Uses [nvchecker(1)](/nvchecker/1.md) and a `.nvchecker.toml` file located alongside the PKGBUILD.

## CONFIGURATION

The `.nvchecker.toml` file must contain a section that matches the package’s pkgbase. The pkgbase section within the `.nvchecker.toml` file specifies the source and method for checking the latest version of the corresponding package.

Use [pkgctl-version-setup(1)](/pkgctl-version-setup/1.md) to automatically detect and setup a basic nvchecker config based on the source array of the package PKGBUILD.

For detailed information on the various configuration options available for the `.nvchecker.toml` file, refer to the configuration files section in [nvchecker(1)](/nvchecker/1.md). This documentation provides insights into the possible options that can be utilized to customize the version checking process.

To supply GitHub or GitLab tokens to nvchecker, a `keyfile.toml` should be placed in the `$XDG_CONFIG_HOME`/nvchecker\` directory. This keyfile is used for providing the necessary authentication tokens required for accessing the GitHub or GitLab API.

## COMBINER SOURCE

To utilize the combiner source, the `pkgbase` section must be declared as the combiner source. Additionally, individual sections should be added using a quoted table key consisting of the `pkgbase` followed by the stage name, separated by double colons. For example: `["sudo:stage1"]`.

This allows to chain different sources together into one result, or allow multi stage transformation of our source via multiple regex.

## OPTIONS

- **-h, --help**

  Show a help text

## SUBCOMMANDS

pkgctl version check

Compares local package versions against upstream

pkgctl version setup

Automatically detect and setup a basic nvchecker config

pkgctl version upgrade

Adjust the PKGBUILD to match the latest upstream version

## SEE ALSO

[pkgctl-version-check(1)](/pkgctl-version-check/1.md) [pkgctl-version-setup(1)](/pkgctl-version-setup/1.md) [pkgctl-version-upgrade(1)](/pkgctl-version-upgrade/1.md)

## HOMEPAGE

 *\<https://gitlab.archlinux.org/archlinux/devtools\>*

*Please report bugs and feature requests in the issue tracker. Please do your best to provide a reproducible test case for bugs.*