The locations of folders used by xpm can be controlled by several environment variables.

Please note that when the variables must be available in GUI applications, setting them in shell init scripts is not effective, since the windows manager usually is not started by a shell, but by other system mechanism, which has its own configuration files.




Global (home) install:

  • ${HOME}/Library/xPacks
  • ${HOME}/Library/Caches/xPacks

System install (not implemented yet):

  • /opt/xPacks with
  • links in /usr/local/bin (normally in PATH)


Global (home) install:

  • ${HOME}/.local/xPacks (was ${HOME}/opt/xPacks in earlier versions)
  • ${HOME}/.cache/xPacks

System install (not implemented):

  • /opt/xPacks
  • links in /usr/local/bin (normally in PATH)


Global (home) install:

  • %APPDATA%\xPacks (C:\Users\ilg\AppData\Roaming\xPacks)
  • %LOCALAPPDATA%\Caches\xPacks (C:\Users\ilg\AppData\Local\Caches\xPacks)

System install (not implemented):

  • %ProgramFiles%\xPacks (C:\Program Files\xPacks)
  • links in %ProgramFiles%\xPacks\.bin, which must be added to the Path

The xPacks folder

Individual packages are stored as separate folders:

  • [@<scope>/]<name>/<version>

The xpm link inside a local package produces a symbolic link from the local package folder to something like:

  • [@<scope>/]<name>/.link

The cache folder

The cache folder is used to store downloaded archives, to avoid downloading them again if referred in other packages.

Further downloads performed by the xPacks should also cache files here (like toolchain binaries).

Setting session wide environment variables

To define session wide environment variables on Windows 10, use the Control Panel and add the variables.

TODO: find out commands to do this in a terminal.

To define session wide environment variables on recent macOS systems, define a User Agent that will issue the launchctl setenv command.

Create a special environment.plist file in the users home directory, for example in ~/Library/LaunchAgents/:

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "">

<plist version="1.0">
  <string>launchctl setenv XPACKS_REPO_FOLDER /Users/myself/location/xpacks</string>

To activate this, run

launchctl load ~/Library/LaunchAgents/environment.plist
launchctl start ~/Library/LaunchAgents/environment.plist

Logout and login.

The new variable should be in the environment, and available to all applications, all shells, etc.

TODO: check if this definition is limited to a user.


TODO: find out how this can be done on Linux.