This document shows how to install Packages from the disk image you've downloaded or fetched via other means.

Packages being a tool to build raw packages and distributions, it shall not be a surprise that its installer is a distribution built by itself.

• Intel or Apple Silicon based Mac

• OS X 10.9 or later

• Installing Packages requires administrative privileges. if you're not the administrator of the machine, contact him/her.

To manually install Packages on a Mac running macOS Catalina, follow these instructions:

To manually install Packages on a Mac running macOS Mojave or earlier, follow these instructions:

Packages being delivered as a distribution, it is possible to install it on a remote computer. Depending on the version of macOS you're running, there are two possible methods for remote installation:

1	Show the original file for the Install Packages alias.
2	Copy the Packages.pkg distribution to the remote computer. Note: If no file sharing services (SMB, AFP, etc.) are running on the remote computer, you will have to physically move to the computer to make the copy and run the installation.
3	Connect to the remote computer using ssh (or telnet).
4	Move to the directory where the Packages.pkg distribution has been copied.
5	Type the following command: $ sudo /usr/sbin/installer -pkg Packages.pkg -target /
6	Press Return.

Apple Remote Desktop (ARD) is a "suite of desktop management tools, enabling administrators to manage networks of Mac OS X system from a central location". Amongst other things, it allows you to remotely install packages or metapackages.

Read page 109 of chapter 8 of the ARD documentation to learn how to perform a remote installation of packages.

macOS Catalina extends the Security and Privacy features introduced in macOS Mojave. If an application needs to access some directories (Documents, Downloads, etc.) within the user's home directory, the application needs to be granted access by the user.

If your Packages projects are stored in your Documents folder, or if some items in your payload are located in a sub-directory of your Home folder, trying to build your project may fail on macOS Catalina.

To make Packages work without any hiccup, it is recommended to grant Full Disk Access to the following components of Packages:

• /Applications/Packages.app

• /Library/PrivilegedHelperTools/fr.whitebox.packages/packages_builder

• /Library/PrivilegedHelperTools/fr.whitebox.packages/packages_dispatcher

If you use the packagesbuild command line tool, you also need to grant Full Disk Access to:

• /usr/local/bin/packagesbuild

To uninstall Packages, you need administrative privileges. If you're not an administrator on the computer, contact him/her.

1	Double-click the Packages.dmg disk image file to mount it on the desktop.
2	Double-click the Packages volume.
3	Double-click the Extras folder.
4	Open the Terminal application.
5	Type sudo sh .
6	Drag and drop the uninstall.sh file from the Finder to the Terminal window. Example: $ sudo sh /Volumes/Packages/Extras/uninstall.sh
7	Press Return to run the command and then type your administrator password.