On this page |
Overview ¶
You can download the Launcher app, then use it to install, manage, and run multiple versions of Houdini. You don’t need to reinstall the launcher when you install a new build of Houdini.
You can start Houdini from the Launcher, or using the traditional methods (desktop app icon, or from the command line in a Houdini shell). You do not need the Launcher to run Houdini.
When you use the Launcher to upgrade Houdini, it downloads the only the parts that have changed. This is a major benefit of using the Launcher, especially for users with slower home Internet connections.
The Launcher also supports offline installation from an ISO image file.
For more information on how to use the launcher to install Houdini, packages, or setup licensing see the Installation and Licensing guide.
Command line options ¶
The general form for running houdini_installer
is:
houdini_installer [global_opts] subcommand [subcommand_opts]
…where subcommand is install, modify, uninstall, repair, list, install-package, or uninstall-package. Most of the time, you only need to use the install and uninstall commands.
You can run:
houdini_install [subcommand] [product] --help
…to display help information.
The global options are:
-h, --help
Display help.
-q, --quiet
Suppress non-error output.
-v, --verbose
Print more progress information.
--settings-file ‹INI file›
Read configurations including login credentials and acceptance to EULA from INI file
.
The configuration file must be in INI format, with lines of the form key = value
.
Keys supported are username
, password
, client_id
, client_secret
, and accept_eula
.
Provide either username/password
or client_id/client_secret
if an action requires user to be logged in.
-o, --log-file ‹file›
Write a detailed installation log to file
. This does not affect the progress information written to stdout
.
Common options across the install
, modify
, repair
, and install-package
subcommands are:
--accept-EULA ‹SideFX-YYYY-MM-DD›
Indicate acceptance of the End User License Agreement with the given date.
--offline-installer ‹path›
The location of an offline installer file.
install
subcommand
¶
Installs a new product/version. If the product can only be installed once per machine (for example, HQueue Server) or the installation directory already contains an installation of that product, installation would not start.
houdini_installer [options] install [install_options] --product <<product>> --version <<version>> [--installdir <<installdir>>]
Mandatory Options:
--product ‹product_name›
One of Houdini
, "Engine 3ds Max|Maya|Unity|Unreal"
, "License Server"
, "HQueue Client"
, or "HQueue Server"
. Note that product names containing spaces must be enclosed in quotes, for example:
houdini_installer install --product "Engine Maya"
--accept-EULA ‹SideFX-YYYY-MM-DD›
Indicate acceptance of the End User License Agreement with the given date.
Mandatory Options (Online Installation):
--version ‹version_number›
The product version to install, including the build number.
--settings-file ‹file_path›
Read configurations including login credentials and acceptance to EULA from INI file
. Keys supported are username
, password
, client_id
, client_secret
, and accept_eula
.
Mandatory Options (Offline Installation):
--offline-installer ‹file_path›
The location of an offline installer file.
Optional Options:
--installdir ‹file_path›
The directory to install to.
--platform ‹platform›
The platform identifier for the build to install. This is only required if there is more than one platform identifier (e.g. linux_x86_64_gcc6.3) available for the version.
--avahi
(Linux platform only) Install Avahi through native package manager 'apt-get' or 'yum'. Having Avahi installed allows License Server to be discoverable by other machines in same local network.
--for-houdini ‹houdini_version›
(Maya Plug-In Only) Install Maya Plug-In for <houdini_version>. Default to Maya Plug-In version if this option is not passed.
modify
subcommand
¶
Moves and/or upgrades or downgrades the version of an existing installation.
houdini_installer [options] modify [modify_options] installdir
Required argument:
installdir
The directory containing the installation directory.
Mandatory Options (Online Installation):
--settings-file ‹file_path›
Read configurations including login credentials and acceptance to EULA from INI file
. Keys supported are username
, password
, client_id
, client_secret
, and accept_eula
.
Mandatory Options (Offline Installation):
--offline-installer ‹file_path›
The location of an offline installer file.
Options:
--installdir ‹installdir›
The directory to move the installation to.
--version ‹version›
The version to update to.
--platform ‹platform›
The platform identifier for the build to install.
--for-houdini ‹houdini_version›
(Maya Plug-In Only) Install Maya Plug-In for <houdini_version>.
--accept-EULA ‹SideFX-YYYY-MM-DD›
Indicate acceptance of the End User License Agreement with the given date.
uninstall
subcommand
¶
Removes an installed product/version.
houdini_installer [options] uninstall [uninstall_options] installdir
Required argument:
installdir
The directory containing the installation to uninstall.
repair
subcommand
¶
Tries to fix problems with a broken installation (for example, missing files).
houdini_installer [options] repair [repair_options] installdir
Required argument:
installdir
The directory containing the installation to repair.
Options:
--settings-file ‹file_path›
Read configurations including login credentials and acceptance to EULA from INI file
. Keys supported are username
, password
, client_id
, client_secret
, and accept_eula
.
--offline-installer ‹file_path›
The location of an offline installer file.
list
subcommand
¶
Lists installed products/versions.
houdini_installer [options] list [directory]...
Optional argument(s):
directory
The install directories to list details about. If none are given, it will list details about all installations.
install-package
subcommand
¶
Installs a new Houdini package from a URL or an offline ISO file. Default URL is https://www.sidefx.com/download/download-labs/packages/, which hosts different versions of SideFX Labs. Houdini ISO file also has SideFX Labs shipped.
houdini_installer [options] install-package [install_package_options] [--installdir <<installdir>>]
Options:
--package-name ‹package_name›
The name of package to install. This is required if there are multiple packages available from download source.
--url ‹URL›
A URL hosting packages.json file. By default, Launcher checks packages hosted on https://www.sidefx.com/download/download-labs/packages/
--installdir ‹file_path›
The directory to install to.
--settings-file ‹file_path›
Read configurations including login credentials and acceptance to EULA from INI file
. Keys supported are username
, password
, client_id
, client_secret
, and accept_eula
.
uninstall-package
subcommand
¶
Removes an installed Houdini package.
houdini_installer [options] uninstall-package package_path
Required argument:
package_path
Path of the package JSON file. For example:
houdini_installer uninstall-package "/Applications/Houdini/sidefx_packages/SideFXLabs18.5.json"