> ## Documentation Index
> Fetch the complete documentation index at: https://sitectl.libops.io/llms.txt
> Use this file to discover all available pages before exploring further.

# bump

> Run targeted Renovate dependency updates for a sitectl project.

export const Compose = () => <Tooltip headline="Compose" tip={<>
        Docker Compose is Docker's tool for defining and running multi-container applications.{" "}
        <a href="https://docs.docker.com/compose/">https://docs.docker.com/compose/</a>.
      </>}>
    <>
      <Icon icon="docker" />
      {" "}
      Compose
    </>
  </Tooltip>;

The `bump` command runs Renovate in Docker for a `sitectl` project. Use it to update <Compose /> image tags, GitHub Actions, and application dependencies without editing dependency files by hand.

Compose templates pin direct images as `tag@sha256:digest`. Renovate keeps that human-readable version and immutable digest together; do not remove the digest to make an update easier. A Dockerfile base-tag change can also change the upstream application release for OJS, Omeka, or ArchivesSpace, while Composer changes control Drupal, ISLE, and WordPress application code. Review those updates as application releases, including backups, smoke tests, and migration gates.

Pick exactly one update level. Levels are cumulative: `--minor` includes patch updates, and `--major` includes minor and patch updates.

```bash theme={null}
sitectl bump --patch
sitectl bump --minor
sitectl bump --major
```

With `--context`, `sitectl` uses that local context's project directory:

```bash theme={null}
sitectl bump --major --context drupal-local
```

Without `--context`, it uses the current working directory:

```bash theme={null}
cd ./drupal
sitectl bump --minor
```

Use `--dry-run` to inspect Renovate's candidate updates without creating branches or pull requests:

```bash theme={null}
sitectl bump --patch --dry-run
```

By default, all update scopes are enabled. Turn scopes off when you want a narrower update:

```bash theme={null}
sitectl bump --minor --compose=off
sitectl bump --patch --actions=off --dependencies=off
```

For non-dry runs, Renovate needs a GitHub token. Set `RENOVATE_TOKEN` or `GITHUB_TOKEN` in the shell before running the command.

## Reference

Run Renovate in Docker for the selected repository.

With `--context`, sitectl uses that local context's project directory. Without
`--context`, sitectl uses the current working directory. Dry runs analyze the
local checkout and print Renovate's candidate updates. Non-dry runs infer the
GitHub repository from origin and create or update Renovate branches and PRs.

```bash theme={null}
sitectl bump (--patch|--minor|--major)
```

| Flag             | Default | Description                                                          |
| ---------------- | ------- | -------------------------------------------------------------------- |
| `--actions`      | `on`    | Update GitHub Actions dependencies: on or off.                       |
| `--compose`      | `on`    | Update Docker Compose dependencies: on or off.                       |
| `--dependencies` | `on`    | Update application dependencies: on or off.                          |
| `--dry-run`      | `false` | Print Renovate's candidate updates without creating branches or PRs. |
| `--major`        | `false` | Allow major, minor, and patch updates.                               |
| `--minor`        | `false` | Allow minor and patch updates.                                       |
| `--patch`        | `false` | Allow patch updates only.                                            |