Skip to content

Getting Started with Hub

Hub is a SaaS platform that gives you access to all of Pachyderm's functionalities without the burden of deploying and maintaining it locally or in a third-party cloud platform.

This section walks you through the steps of creating a workspace in Hub so that you do not need to worry about the underlying infrastructure and can get started right away.


Let us know how to improve Hub. Join our Slack channel.

Get started in 4 simple steps

Hub Steps

Before you start

Log in with your GitHub or Google account to start using Hub Login

1- Create a Workspace

Click the Create a 4-hr Workspace button and fill out the form. Hub workspace

You just provisioned a one-node cluster that you can now use for a limited time for free!


While Pachyderm maintains a few clusters that are instantly available, none may be available during periods of high traffic. If you see your workspace is in a starting state, you might have to wait a few minutes for it to be ready.

2- Install pachctl

Hub enables you to access your workspace through Pachyderm CLI pachctl and the web interface called the Dashboard. Although you can perform most simple actions directly in the Dashboard, pachctl provides full functionality. Most likely, you will use pachctl for any operation beyond the most basic workflow. We recommend that you use pachctl for all data operations and the Dashboard to view your data and graphical representation of your pipelines.

After your workspace creation, open a terminal window and install 'pachctl'.


kubectl commands are not supported for the workspaces deployed on Hub.

3-4 Configure your Pachyderm context and login to your workspace by using a one-time authentication token

  1. To configure a Pachyderm context and log in to your workspace (i.e. have your pachctl point to your new workspace), click the Connect link on your workspace name in the Hub UI.

    Pachyderm workspace running

    In your terminal window, copy, paste, and run the commands 1,2,3 listed in the instructions.

    Pachyderm workspace connect

    Note Your token has a limited lifetime. The following error means that your authentication token has expired. Close the pop-up window and re-connect.

       error authenticating with Pachyderm cluster: otp is invalid or has expired

  2. Verify that you have set the correct context:

    pachctl config get active-context
    The system should return the name of your workspace.

  3. Create a test repo:

    pachctl create repo test
    pachctl list repo
    System response
    test 5 seconds ago 0B            OWNER    

  4. Check the repo in your dashboard:

    In the Hub UI, click the Details button next to your workspace name, then Dash. Your dashboard opens in a new window.


Next Step

You have successfully deployed and configured a Pachyderm workspace in Hub.

Next: Beginner Tutorial

Last update: April 5, 2021
Does this page need fixing? Edit me on GitHub