Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
PKG-REPOSITORIES(8)	     System Manager's Manual	     PKG-REPOSITORIES(8)

NAME
     pkg repositories -- display and manage package repositories

SYNOPSIS
     pkg repositories [-d] [-e] [-l] [repository]
     pkg repositories repository enable | disable | reset

DESCRIPTION
     pkg  repositories displays configured software repositories for the package
     manager, pkg(8).

     If given the name of an existing repository as an argument, only print  its
     configuration.  Without arguments all repositories are printed.

     When  a  repository  name	is  followed  by  an action (enable, disable, or
     reset), pkg repositories manages a persistent override for the repository's
     enabled   state.	 The   override   is   stored	as    a    file    under
     $PKG_DBDIR/repos_state/enable/ or $PKG_DBDIR/repos_state/disable/ and takes
     precedence over the configuration files regardless of the override chain.

     The reset action removes the override, reverting to the value from the con-
     figuration files.

     When  a  repository's state is overridden, the pkg repositories and pkg -vv
     commands display "(overridden by pkg)" next to the enabled status.

OPTIONS
     The following options are supported by pkg repositories:

     -d, --disabled
	    Print disabled repositories only.

     -e, --enabled
	    Print enabled repositories only.

     -l, --list
	    Print the list of repository names.

ACTIONS
     enable   Force the repository to be enabled, overriding  the  configuration
	      files.

     disable  Force  the repository to be disabled, overriding the configuration
	      files.

     reset    Remove a previous override, reverting to	the  configuration  file
	      value.

FILES
     /etc/pkg/FreeBSD.conf		 default system repository

     /usr/local/etc/pkg/pkg.conf	 pkg(8)  configuration, including system
					 repository

     /usr/local/etc/pkg/pkg.conf.sample  example  pkg(8)  monolithic  configura-
					 tion, including default repository

     /usr/local/etc/pkg/repos/		 location for site specific repositories

     /var/db/pkg/repos_state/enable/	 directory containing override files for
					 enabled repositories

     /var/db/pkg/repos_state/disable/	 directory containing override files for
					 disabled repositories

EXAMPLES
     Display all repositories:

	   pkg repositories -l

     Display all repositories configurations:

	   pkg repositories

     Disable a repository:

	   pkg repositories FreeBSD-ports disable

     Re-enable it:

	   pkg repositories FreeBSD-ports enable

     Remove the override (revert to configuration):

	   pkg repositories FreeBSD-ports reset

SEE ALSO
     pkg_checksum(3),  pkg_create(3), pkg_printf(3), pkg_repo_create(3), pkg_re-
     pos(3),   pkg-keywords(5),   pkg-lua-script(5),   pkg-repository(5),   pkg-
     script(5),  pkg-triggers(5), pkg.conf(5), pkg(8), pkg-add(8), pkg-alias(8),
     pkg-annotate(8), pkg-audit(8), pkg-autoremove(8), pkg-check(8),  pkg-check-
     sum(8),  pkg-clean(8),  pkg-config(8),  pkg-create(8),  pkg-delete(8), pkg-
     fetch(8),	pkg-help(8),  pkg-info(8),  pkg-install(8),   pkg-key(8),   pkg-
     lock(8),  pkg-plugins(8),	pkg-query(8), pkg-register(8), pkg-repo(8), pkg-
     rquery(8), pkg-rwhich(8),	pkg-search(8),	pkg-set(8),  pkg-shell(8),  pkg-
     shlib(8),	pkg-ssh(8),  pkg-stats(8),  pkg-triggers(8),  pkg-unregister(8),
     pkg-update(8),  pkg-updating(8),	pkg-upgrade(8),   pkg-version(8),   pkg-
     which(8)

FreeBSD ports 15.quarterly	 April 18, 2026 	     PKG-REPOSITORIES(8)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=pkg-repositories&sektion=8&manpath=FreeBSD+15.1-RELEASE+and+Ports.quarterly>

home | help