setup

Guides contributors through LFX One environment setup from prerequisites to running dev server.

12|6|Updated Jul 14, 2025
One-click install
npx skills add https://github.com/linuxfoundation/lfx-self-serve --skill setup-linuxfoundation
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: setup
Source: https://github.com/linuxfoundation/lfx-self-serve/tree/main/.claude/skills/setup
Command: npx skills add https://github.com/linuxfoundation/lfx-self-serve --skill setup-linuxfoundation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? New contributors often struggle with first-time environment setup: wrong Node or Yarn versions, missing environment variables, Corepack failures, and broken local authentication. This Skill walks through the entire LFX One setup interactively, verifying each step before moving on. ## Core Features & Use Cases - Prerequisite Verification: Checks Node.js 22.13+, Yarn 4.9.2+ via Corepack, and Git, with install guidance for each. - Environment Variable Validation: Copies the .env template, pulls credentials from the 1Password vault, and runs a shell script to confirm all critical Auth0 and service variables are populated. - Troubleshooting & Auth Debugging: Diagnoses Corepack errors, port conflicts, stale cookies, and rotated Authelia client secrets for the local k8s auth stack. - Use Case: A new engineer joins the team and asks how to get started. The Skill walks them through cloning the repo, configuring .env from 1Password, running yarn install, starting the dev server, and verifying the login page loads at localhost:4200. ## Quick Start Ask the assistant to walk you through setting up the LFX One development environment from scratch.

Frequently Asked Questions about setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up the LFX One development environment?▼

Verify Node.js 22.13+ and Yarn 4.9.2+ are installed, clone the repository, copy apps/lfx-one/.env.example to .env, fill in credentials from the 1Password vault, run yarn install, then yarn start. The app loads at http://localhost:4200.

How do I fix yarn install failing with a Corepack error?▼

Run corepack enable followed by corepack prepare yarn@4.9.2 --activate to register the correct Yarn version. Also confirm Node.js 22.13+ is active, and if problems persist, delete node_modules and .yarn/cache before retrying.

Do I need Docker for local LFX One development?▼

No, Docker is not required. All services point to the shared dev environment, so there are no local databases, message brokers, or infrastructure to run on your machine.

Why is local login broken with Authelia?▼

The most common causes are stale browser cookies or a rotated client secret. Clear cookies for localhost:4200, then re-fetch the secret with kubectl get secrets authelia-clients -n lfx and update your .env file.

What environment variables are required for LFX One?▼

Critical variables include PCC_AUTH0_CLIENT_ID, PCC_AUTH0_CLIENT_SECRET, PCC_AUTH0_ISSUER_BASE_URL, PCC_AUTH0_AUDIENCE, PCC_AUTH0_SECRET, PCC_BASE_URL, and LFX_V2_SERVICE. Values come from the LFX One Dev Environment vault in 1Password, except PCC_AUTH0_SECRET which is any long random string.