rv configure repository

Used to add, update, or remove repositories from the configuration file, while maintaining the file’s formatting and comments.

This command has 5 subcommands for fine tuned repository configuration.

add

Adds a new repository to the repositories section of the config file.

Usage

rv configure repository add <ALIAS> --url <URL> [OPTIONS]

Arguments

• ALIAS - the repository alias to add

Options

• --url <URL> required - the url of the repository to add
• --force-source - enable force_source for this repository
• --first — Add as first repository entry
• --last default - Add as last repository entry
• --before <alias> - Add before the specified alias
• --after <alias> - Add after the specified alias

Examples

All examples on this page will start with the following configuration:

rproject.toml

[project]
name = "configure"
repositories = [
    { alias = "CRAN", url = "https://cran.r-project.org" },
    { alias = "PPM", url = "https://packagemanager.posit.co/cran/2025-01-01" },
]

Add repository as last entry

rv configure repository add "bioconductor" --url "https://bioconductor.org/packages/3.18/bioc"
OR
rv configure repository add "bioconductor" --url "https://bioconductor.org/packages/3.18/bioc" --last

Updated Config File

rproject.toml

[project]
name = "configure"
repositories = [
    { alias = "CRAN", url = "https://cran.r-project.org" },
    { alias = "PPM", url = "https://packagemanager.posit.co/cran/2025-01-01" },
    { alias = "bioconductor", url = "https://bioconductor.org/packages/3.18/bioc" },
]

Command Output

Repository 'bioconductor' added successfully with URL: https://bioconductor.org/packages/3.18/bioc

Add a repository with force_source as the middle repository

rv configure repository add "bioconductor" --url "https://bioconductor.org/packages/3.18/bioc" --force-source --after CRAN
OR
rv configure repository add "bioconductor" --url "https://bioconductor.org/packages/3.18/bioc" --force-source --before PPM

Updated Config File

rproject.toml

[project]
name = "configure"
repositories = [
    { alias = "CRAN", url = "https://cran.r-project.org" },
    { alias = "bioconductor", url = "https://bioconductor.org/packages/3.18/bioc", force_source = true },
    { alias = "PPM", url = "https://packagemanager.posit.co/cran/2025-01-01" },
]

Command Output

Repository 'bioconductor' added successfully with URL: https://bioconductor.org/packages/3.18/bioc

replace

Replace an existing repository entry, keeping the original alias unless otherwise specified.

Usage

rv configure repository replace <OLD_ALIAS> --url <URL> [OPTIONS]

Arguments

• OLD_ALIAS - the repository alias to replace

Options

• --url <URL> required - the url of the repository to replace
• --alias <ALIAS> - new repository alias. Will keep the original alias if not specified.
• --force-source - enable/disable force_source for this repository

Example

We start with the same configuration file as the first example, then update the CRAN alias to be the latest Posit Package Manager url and enable the force_source option using the following command:

rv configure repository replace CRAN --url "https://packagemanager.posit.co/cran/latest" --force-source

Updated Config File

rproject.toml

[project]
name = "configure"
repositories = [
    { alias = "CRAN", url = "https://packagemanager.posit.co/cran/latest", force_source = true },
    { alias = "PPM", url = "https://packagemanager.posit.co/cran/2025-01-01" },
]

Command Output

Repository replaced successfully - new alias: 'CRAN', URL: https://packagemanager.posit.co/cran/latest

update

Update an existing repository’s fields

Usage

rv configure repository update <TARGET_ALIAS> [OPTIONS]

Arguments

• TARGET_ALIAS - The alias of the repository to update. Required unless using --match-url

Options

• --match-url <URL> - Match repository based on the URL instead of the alias
• --alias <ALIAS> - The new repository alias
• --url <URL> - The new repository url
• --force-source - Enable force_source
• --no-force-source - Disable force_source

Examples

Updating a repositories snapshot date

rv configure repository update PPM --url "https://packagemanager.posit.co/cran/2025-05-01"

Updated Config File

rproject.toml

[project]
name = "configure"
repositories = [
    { alias = "CRAN", url = "https://cran.r-project.org" },
    { alias = "PPM", url = "https://packagemanager.posit.co/cran/2025-05-01" },
]

Command Output

Repository 'PPM' updated successfully

Updating a CRAN URL

rv configure repository update --match-url https://cran.r-project.org -- url https://cran.rstudio.com

Updated Config File

rproject.toml

[project]
name = "configure"
repositories = [
    { alias = "CRAN", url = "https://cran.rstudio.com" },
    { alias = "PPM", url = "https://packagemanager.posit.co/cran/2025-05-01" },
]

Command Output

Repository 'CRAN' updated successfully

remove

Remove an existing repository

Usage

rv configure repository <ALIAS> [OPTIONS]

Arguments

• ALIAS - repository alias to remove

Example

We start with the same configuration file as the first example, then to remove CRAN as a repository entry, we will use the following command:

rv configure repository remove CRAN

Updated Config File

rproject.toml

[project]
name = "configure"
repositories = [
    { alias = "PPM", url = "https://packagemanager.posit.co/cran/2025-05-01" },
]

Command Output

Repository 'CRAN' removed successfully

clear

Clear all repositories

Usage

rv configure repository clear [OPTIONS]

Example

We start with the same configuration file as the first example, then to clear the repositories section, we run the following command:

rv configure repository clear

Updated Config File

rproject.toml

[project]
name = "configure"
repositories = []

Command Output

All repositories cleared successfully