Skip to main content

Installation

Follow these steps to install LibreApps Desktop and set up your first project.

Step 1: Clone the Repository​

Clone LibreApps Desktop repository from GitHub:

git clone https://github.com/libre-apps/LADesktop.git
cd LibreApps Desktop

Step 2: Choose Your Template​

LibreApps Desktop comes with two kits. Most developers start with the Full-Kit.

# Navigate to the active application
cd build/web/full-kit

Step 3: Install Dependencies​

Use pnpm to install all necessary packages:

pnpm install

Step 4: Configure Environment​

Copy the example environment file to create your local config:

cp .env.example .env

Open .env in your editor and ensure the default settings work for you. For a basic local run, the defaults are usually fine.

Step 5: Initialize Database (Optional)​

If you plan to use database features (like user profiles or chat history) during initial development, you may need to initialize Prisma:

# Generate the Prisma client
pnpm prisma generate

# (Optional) Push the schema to a local SQLite/PostgreSQL
# pnpm prisma db push

Common Installation Issues​

Error: pnpm install fails​

  • Fix: Ensure you are using Node.js 20+. Try pnpm install --no-frozen-lockfile if dependencies have changed significantly.

Error: shadcn command not found​

  • Fix: LibreApps Desktop uses npx shadcn@latest for component management. Ensure you have network access.

Installation complete! Launch the App →