Skip to main content
This guide outlines the path from a running LStack dashboard to a project that can execute tickets.

​
Prerequisites

Before you begin:
  • Install and start LStack.
  • Start Docker if you want to create workers or use container-based project runtimes.
  • Make sure a compatible model endpoint is reachable from Docker containers.
  • On Linux, run lstack setup-confinement before creating your first worker.
  • Open the dashboard with lstack open, or open the matching SSH tunnel address for a headless installation.

​
Complete first-time setup

On a new installation, the browser guides you through Welcome → Project location → Readiness → Sign in. Keep the default ~/LStack-Projects location or select another folder on the computer running LStack. The Readiness screen reports worker prerequisites, but missing prerequisites do not block access to the dashboard.
On a new Linux installation with no workers, Readiness may be unable to determine the confinement state. Run lstack setup-confinement before creating the first worker even if the screen cannot determine it.

​
Configure LStack

1

Add a provider

Open Providers, create a provider for your model endpoint, add its authentication details, and validate the connection.
2

Prepare the worker image

Open Settings → Workers and build the managed worker image. Build or rebuild progress and logs appear in the dashboard.
3

Create a worker

Open Workers, select the provider, choose a worker policy, and create the worker. Wait for it to report as available.
4

Create a project

Open All projects, create a project, and select or create its workspace folder on the host computer.
5

Configure worker access

Choose which workers the project may use. A ticket can run only when an eligible worker is available to that project.
6

Create a ticket

Add a ticket to the board with a clear objective, then move it into the runnable workflow. Follow its execution status and session output from the dashboard.

​
Verify the installation

Use the CLI to confirm that the core is healthy:
If the dashboard works but worker actions are unavailable, check that Docker is running and that the worker image has been built.

Dashboard overview

Learn where the main product surfaces live.

Diagnostics

Diagnose startup, Docker, configuration, and database issues.