Skip to main content

Getting started

This page gets you from a fresh account to a completed workflow run.

Sign in

Workflows is a web application — everything happens in the browser, and there is nothing to install.

  1. Open your organization's Workflows URL (for example https://workflows.fossid.com).
  2. Sign in with the identity provider your organization uses.
  3. If you were invited by email, follow the invitation link instead. It signs you in and adds you to the right organization in one step.

The Workflows sign-in page

Organizations

Every workflow, connection, and execution belongs to an organization. Organizations keep tenants separate: you only ever see data belonging to the organization you are signed in to.

If your account is not yet a member of one, you are taken to onboarding to create or join an organization before you can continue.

Find your way around

The sidebar is the main navigation:

SectionWhat it is for
DashboardActivity overview — execution counts, workflow states, recent runs.
WorkflowsThe list of your workflows. Create, open, edit, and publish them here.
ConnectionsCredentials for external systems: databases, the FossID Knowledge Base, and FossID Workbench.
UsersOrganization members, invitations, and roles.
SettingsOrganization and personal preferences, including theme.
DocumentationOpens this documentation.

The Workflows dashboard

Run your first workflow

The fastest path to seeing Workflows actually do something is to start from a template rather than an empty canvas.

  1. Go to Workflows and create a new one. You are offered a set of ready-made starting points — see Starting from a template. Can I trust this SBOM? is the one to pick first: it takes an SBOM, verifies its licenses, checks it against regulations, and produces a PDF of what it found.
  2. Fill in anything the template leaves blank. Steps that reach outside the platform need a connection — verifying licenses needs FossID Knowledge Base access, for instance.
  3. Publish it. Only published workflows can run; a draft is still being edited.
  4. Trigger it by opening the workflow's upload page and submitting an SBOM. See Using the upload portal.
  5. Open the workflow's details page and watch the execution progress. Each node reports its own status as it runs.
  6. When the run finishes, download the outputs from the execution.

Prefer to build it yourself? Build your first workflow assembles the same pipeline node by node.

  • Core concepts — what workflows, nodes, edges, and executions actually are. Worth reading before you build anything non-trivial.
  • Build your first workflow — a step-by-step build of a real compliance pipeline.
  • Node reference — what each processing step does and how to configure it.
  • Troubleshooting — when a run does not do what you expected.