Skip to main content

Install On-Premises

This section describes how to install Designer Cloud Powered by Trifacta Enterprise Edition within your enterprise infrastructure.

To install Designer Cloud Powered by Trifacta Enterprise Edition inside your enterprise infrastructure, please review and complete the following sections in the order listed below.

Scenario Description

  • Installation of Designer Cloud Powered by Trifacta Enterprise Edition on a server on-premises

  • Installation of Alteryx databases on a server on-premises

  • Integration with a supported Hadoop cluster on premises.

  • Base storage layer of HDFS


Deployment Limitations


Product Limitations

For general limitations of Designer Cloud Powered by Trifacta Enterprise Edition, see Product Limitations in the Planning Guide.


Please acquire the following assets:

  • Install Package: Acquire the installation package for your operating system.

    • License Key: As part of the installation package, you should receive a license key file. See License Key for details.

    • For more information, contact Alteryx Support.

  • Offline system dependencies: If you are completing the installation without Internet access, you must also acquire the offline versions of the system dependencies. See Install Dependencies without Internet Access.


Before you install Designer Cloud Powered by Trifacta Enterprise Edition, please complete the following steps.

  1. Deploy Hadoop cluster: In this scenario, the Designer Cloud Powered by Trifacta platform does not create a Hadoop cluster.


    Installation and maintenance of a working Hadoop cluster is the responsibility of the customer. Guidance is provided below on the requirements for integrating the platform with the cluster.

  2. Deploy Trifacta node:Designer Cloud Powered by Trifacta Enterprise Edition must be installed on an edge node of the cluster.

Details are below.

Deploy the Cluster

In your enterprise infrastructure, you must deploy a cluster using a supported version of Hadoop to manage the expected data volumes of your Alteryx jobs.

The Designer Cloud Powered by Trifacta platform supports integration with the following cluster types. For more information on the supported versions, please see the listed sections below.


Cluster information including cluster configuration files must be accessible to the Trifacta node. These requirements are described in the following section.

Job execution:

  • By default, smaller jobs are executed in the Photon running environment on the Trifacta node.

  • Larger jobs are executed using Spark on the integrated Hadoop cluster. A supported version of Spark must be installed on the cluster. For more information, seeSystem Requirementsin the Planning Guide.

Prepare the cluster

Please verify or complete the following steps if you are integrating with a Hadoop cluster:

  1. On the Hadoop cluster:

    1. Create a user [hadoop.user (default=trifacta)] and a group for it [ (default=trifactausers)].

    2. Create the following directories:

      1. /trifacta

      2. /user/trifacta

    3. Change the ownership of /trifacta and /user/trifacta to trifacta:trifacta or the corresponding values for the Hadoop user in your environment.


      You must verify that the [hadoop.user] user has complete ownership and full access to Read, Write and Execute on these directories recursively.

  2. Verify that WebHDFS is configured and running on the cluster.

  3. Software installation is completed on a dedicated node in the cluster. The user installing the Alteryx software must have sudo access.

  4. If you are installing on a server with an older instance of Postgres, you should remove the older version or change the default ports.

For more information, see Prepare Hadoop for Integration with the Platform in the Configuration Guide.

Additional users may be required. For more information, see Required Users and Groups in the Planning Guide.

Deploy the Alteryx node

An edge node of the cluster is required to host the Designer Cloud Powered by Trifacta platform software. For more information on the requirements of this node, see System Requirements in the Planning Guide.

Install Process

The installation and configuration process requires the following steps. To continue, see Next Steps below.

  1. Install software: Install the Designer Cloud Powered by Trifacta platform software on the Trifacta node. See Install Software.

  2. Install databases: The platform requires several databases for storage.


    The default configuration assumes that you are installing the databases on a PostgreSQL server on the same edge node as the software using the default ports. If you are changing the default configuration, additional configuration is required as part of this installation process.

    For more information, see Install Databases in the Databases Guide.

  3. Start the platform: For more information, see Start and Stop the Platform.

  4. Login to the application: After software and databases are installed, you can login to the application to complete configuration:

    1. See Login.

    2. As soon as you login, you should change the password on the admin account. In the left nav bar, select User menu > Admin console > Admin settings. Scroll down to Manage Users. For more information, see Change Admin Password in the Configuration Guide.


      At this point, you can access the online documentation through the application. In the left nav bar, select Resources menu > Documentation. All of the following content, plus updates, is available online. See Documentation below.

  5. Install configuration: After you are able to successfully login to the Trifacta Application, you must configure the product to work with your backend storage layer and the running environment on the cluster. See Install Configuration.

Next Steps

To continue, please install the Alteryx software on the Trifacta node.


Please complete the installation steps for the operating system version that is installed on the Trifacta node.

See Install Software.