PKGSRC / INSTALLATION

SMARTOS / ILLUMOS

Binary packages for illumos, without a moving target.

Choose the standard set for illumos distributions, or the deliberately smaller tools set for a SmartOS Global Zone.

PACKAGE SET

Choose a known base.

Built on SmartOS 20210826; intended for illumos distributions of at least that date.

Important. Run install and upgrade commands from a root shell. Bootstrap kits are for a fresh pkgsrc installation. If pkgsrc is already installed, use the matching upgrade kit or pkgin upgrade instead of unpacking a bootstrap over it.

01

Standard

General illumos package set.

Install

# Prerequisite: run this block from a root shell.
BOOTSTRAP_TAR="bootstrap-trunk-x86_64-20260811.tar.gz"
BOOTSTRAP_SHA="e5e620ade4b45695aa385aea25227e94f49f078f"

# Download the bootstrap kit to the current directory.
curl -O https://pkgsrc.smartos.org/packages/SmartOS/bootstrap/${BOOTSTRAP_TAR}

# Verify the SHA1 checksum before unpacking.
[ "${BOOTSTRAP_SHA}" = "$(/bin/digest -a sha1 ${BOOTSTRAP_TAR})" ] || { echo "ERROR: checksum failure" >&2; exit 1; }

# Optional: verify the PGP signature (requires gpg).
# curl -O https://pkgsrc.smartos.org/packages/SmartOS/bootstrap/${BOOTSTRAP_TAR}.asc
# curl -sS https://pkgsrc.smartos.org/pgp/8254B861.asc | gpg2 --import
# gpg2 --verify ${BOOTSTRAP_TAR}{.asc,}

# Unpack the kit to /opt/local.
tar -zxpf ${BOOTSTRAP_TAR} -C /

# Add pkgsrc tools to this shell.
PATH=/opt/local/sbin:/opt/local/bin:$PATH
MANPATH=/opt/local/man:$MANPATH
Upgrade this package set

Use an upgrade kit only when package configuration or signing keys need to change. For normal maintenance, run pkgin upgrade.

# Prerequisite: run this block from a root shell.
UPGRADE_TAR="bootstrap-trunk-x86_64-20260811-upgrade.tar.gz"
UPGRADE_SHA="d94e31661b3ba5a69cfd1f49b5c0c8e8aa27e92f"

# Download the upgrade kit to the current directory.
curl -O https://pkgsrc.smartos.org/packages/SmartOS/bootstrap-upgrade/${UPGRADE_TAR}

# Verify the SHA1 checksum before unpacking.
[ "${UPGRADE_SHA}" = "$(/bin/digest -a sha1 ${UPGRADE_TAR})" ] || { echo "ERROR: checksum failure" >&2; exit 1; }

# Optional: verify the PGP signature (requires gpg).
# curl -O https://pkgsrc.smartos.org/packages/SmartOS/bootstrap-upgrade/${UPGRADE_TAR}.asc
# curl -sS https://pkgsrc.smartos.org/pgp/8254B861.asc | gpg2 --import
# gpg2 --verify ${UPGRADE_TAR}{.asc,}

# Unpack the kit to /opt/local.
tar -zxpf ${UPGRADE_TAR} -C /

# Ensure package tools and installed packages are current.
/opt/local/sbin/pkg_add -U pkg_install pkgin libarchive
/opt/local/bin/pkgin clean
/opt/local/bin/pkgin -y upgrade
02

Tools · SmartOS GZ

A smaller set designed for the Global Zone. Download from /var/tmp; the GZ bootstrap uses curl -k.

Install

cd /var/tmp

# Prerequisite: run this block from a root shell.
BOOTSTRAP_TAR="bootstrap-trunk-tools-20260804.tar.gz"
BOOTSTRAP_SHA="703e6b381320e1176ee84587a1430e0994aeff71"

# Download the bootstrap kit to the current directory.
curl -kO https://pkgsrc.smartos.org/packages/SmartOS/bootstrap/${BOOTSTRAP_TAR}

# Verify the SHA1 checksum before unpacking.
[ "${BOOTSTRAP_SHA}" = "$(/bin/digest -a sha1 ${BOOTSTRAP_TAR})" ] || { echo "ERROR: checksum failure" >&2; exit 1; }

# Optional: verify the PGP signature (requires gpg).
# curl -kO https://pkgsrc.smartos.org/packages/SmartOS/bootstrap/${BOOTSTRAP_TAR}.asc
# curl -sS https://pkgsrc.smartos.org/pgp/8254B861.asc | gpg2 --import
# gpg2 --verify ${BOOTSTRAP_TAR}{.asc,}

# Unpack the kit to /opt/tools.
tar -zxpf ${BOOTSTRAP_TAR} -C /

# Add pkgsrc tools to this shell.
PATH=/opt/tools/sbin:/opt/tools/bin:$PATH
MANPATH=/opt/tools/man:$MANPATH
Upgrade this package set

Use an upgrade kit only when package configuration or signing keys need to change. For normal maintenance, run pkgin upgrade.

# Prerequisite: run this block from a root shell.
UPGRADE_TAR="bootstrap-trunk-tools-20260804-upgrade.tar.gz"
UPGRADE_SHA="3707bcbcf83187d871fdc020d4a4c964e343c9cc"

# Download the upgrade kit to the current directory.
curl -kO https://pkgsrc.smartos.org/packages/SmartOS/bootstrap-upgrade/${UPGRADE_TAR}

# Verify the SHA1 checksum before unpacking.
[ "${UPGRADE_SHA}" = "$(/bin/digest -a sha1 ${UPGRADE_TAR})" ] || { echo "ERROR: checksum failure" >&2; exit 1; }

# Optional: verify the PGP signature (requires gpg).
# curl -kO https://pkgsrc.smartos.org/packages/SmartOS/bootstrap-upgrade/${UPGRADE_TAR}.asc
# curl -sS https://pkgsrc.smartos.org/pgp/8254B861.asc | gpg2 --import
# gpg2 --verify ${UPGRADE_TAR}{.asc,}

# Unpack the kit to /opt/tools.
tar -zxpf ${UPGRADE_TAR} -C /

# Ensure package tools and installed packages are current.
/opt/tools/sbin/pkg_add -U pkg_install pkgin
/opt/tools/bin/pkgin clean
/opt/tools/bin/pkgin -y upgrade

POST-INSTALL

Operate with pkgin.

pkgin is the binary package front end. The underlying pkg_add, pkg_info, pkg_create, and pkg_admin tools remain available when you need them.

# Run this block from a root shell.
# Standard illumos set:
PKGSRC_PREFIX=/opt/local
# SmartOS Global Zone tools set instead:
# PKGSRC_PREFIX=/opt/tools

# Refresh repository metadata
${PKGSRC_PREFIX}/bin/pkgin -y update

# Find, install, and upgrade packages
${PKGSRC_PREFIX}/bin/pkgin search ^ffmpeg[0-9]$
${PKGSRC_PREFIX}/bin/pkgin -y install ffmpeg4
${PKGSRC_PREFIX}/bin/pkgin avail
${PKGSRC_PREFIX}/bin/pkgin -y upgrade
${PKGSRC_PREFIX}/bin/pkgin -y remove ffmpeg4
${PKGSRC_PREFIX}/bin/pkgin -y autoremove

# Inspect installed package metadata and files
${PKGSRC_PREFIX}/sbin/pkg_info
${PKGSRC_PREFIX}/sbin/pkg_info -Fe ${PKGSRC_PREFIX}/bin/ffmpeg4
${PKGSRC_PREFIX}/sbin/pkg_info -qL ffmpeg4

# Refresh the vulnerability list and audit installed packages
${PKGSRC_PREFIX}/sbin/pkg_admin fetch-pkg-vulnerabilities
${PKGSRC_PREFIX}/sbin/pkg_admin audit