Intro: Set Up Your Tulip Instance
  • 09 Jul 2024
  • 5 Minutes to read
  • Contributors

Intro: Set Up Your Tulip Instance


Article summary

What is my Tulip Instance?

The Tulip Platform consists of two main components:

Tulip Instance - Accessed through a web browser via your Instance URL with a username and password or SSO/SAML (URL structure: .tulip.co). It contains all account settings and is where you build and manage apps.

Tulip Player - A separate application used to run the apps you’ve built. It can be downloaded or accessed from a web browser. The Player is how operators will interface with apps on the floor and requires sign-on with SSO/SAML or Badge ID.

Further Reading

Introduction to the Platform

Before we dive into admin controls, let’s briefly explore your Tulip instance. Account Owners need to understand each area of their instance in order to manage controls and user access.

Before deciding the level of access a user needs, it is important to understand how Tulip works and what happens when a user makes a change in each area of the platform. For example, changes to tables go live immediately, while apps are version controlled, meaning you can edit apps without affecting production; changes do not go live until published.

Platform FeatureWhen do changes go live?
App EditorWhen published
Table EditorImmediately
Analytics EditorWhen saved
Automations EditorWhen published
Shop Floor ManagerWhen saved

Your instance is where App Builders or Citizen Developers will build apps, tables, and analyses/dashboards used on the Shop Floor and where you’ll manage the settings and access within each of these areas.

Instance Header.jpg

Dashboards

Create Dashboards and access the Analytics Editor, which is used to build visualizations from Tulip app, table, and machine data.

Account owners are responsible for ensuring only the appropriate users have view or edit access to dashboards and analytics.

Apps

Build applications and any connected systems/data storage structures involved in the use case/solution. Includes the App Editor, Table Editor, and Connector Editor.

Account owners are responsible for setting app roles, restrictions, and platform access level. For example:

  • App Builder access
  • Table Editor access
  • Analytics Editor access
  • Connector Editor access
  • Operator access

You’ll want to ensure only those with adequate training have access to each area of your Instance as well as apps running in the Player. Requiring users to pass exams in Tulip University can be a good alternative to your own internal training program.

Automations

Streamline and automate processes to run continuously in the background using the Automations Editor. Unlike apps, which run only when open/in use, automations enable process flows triggered via timer or event. Automations are a separate, usage-based package.

Account owners are responsible for ensuring only the appropriate users have view or edit access to Automations.

Shop Floor

Create and manage who has access to Tulip stations, assign apps and Interface (display devices) to stations, and set up and manage machines, edge devices, and vision.

Account owners, often in collaboration with IT, are responsible for:

  • Creating and managing Interfaces
  • Creating and managing stations
  • Ensuring the correct version of apps are running at each station
  • Assigning apps to stations

Instance Settings

In your instance, you will find account and/or workspace settings depending on your account type.

Account owners are responsible for setting up initial Account/Workspace settings and appearance:

Tulip Profile.jpg

Account Settings

Account settings apply to the entire instance. If you have workspaces enabled, you will need to go to Workspace Settings to customize each workspace. Your Tulip account settings can include the following controls depending on your account type:

ControlPlan (starts at)When to use
AccountEssentialsSet up name and appearance of your instance.
API tokensProfessionalUse the Tulip API to read/write to Tulip’s database (see: Tulip Docs).
App ExchangeEnterpriseCreate a library of apps within a workspace and share those apps with other workspaces and instances.
Color paletteEssentialsChange the palette options in the App Editor to help keep App Builders on-brand.
Custom widgetsProfessionalEnables the creation of widgets using custom HTML, Javascript, and CSS.
Date and timeEssentialsChoose the Default Time Zone, and customize the Datetime format. *When workspaces are enabled, this setting applies only to the date format, while time zones can be configured in workspace settings.
Edge devicesProfessionalSet up automatic Firmware Updates and determine when they'll occur.
Frontline Copilot®EssentialsEnable/disable AI features.
Network accessEssentialsConfigure your IP Allowlist to override the default settings that allow Tulip account access from any location.
PlayerEssentialsConfigure Player settings.
UsersEssentialsCreate and edit Tulip Users and User Roles.
WorkspacesEnterpriseCreate new or view existing workspaces.

Further Reading

Account Usage

The account usage page provides a high-level overview of the usage across your instance. Usage is categorized into cards for machines, interfaces, automations, and Frontline Copilot®.

Data in the Account Usage page is helpful for:

  • Tracking usage-based features in the platform
  • Resource allocation
  • Capacity planning
  • Communicating with stakeholders

When product limits are approaching, they are highlighted on the Usage Page. Regularly check the Account Usage page to stay informed about your resource consumption. This will help you ensure that you are within your plan limits and can anticipate any potential overages.

Use the data to communicate with stakeholders about how the Tulip platform is being used. This can support requests for additional resources or justify the current investment in the platform.

Leverage the historical data available on the Account Usage page to forecast future resource needs. This can help in re-allocating resources, budgeting, and planning for additional resources if needed.

For external tracking, the usage data by month can be exported to a .csv file.

Further Reading

Recent Activity

The “Recent Activity” feed on the main screen of Tulip will show you many types of events across your company’s Tulip Account. You can use it to see:

  • Which apps have been changed recently
  • Which Analyses have been added
  • Which users have created an account
  • And more

Further Reading:


Was this article helpful?