Getting started in SolidStart

Install Lucia using your package manager of your choice.

npm i lucia
pnpm add lucia
yarn add lucia

Initialize Lucia#

Import lucia() from lucia and initialize it in its own module (file). Export auth and its type as Auth. Make sure to pass the web() middleware. We also need to provide an adapter but since it’ll be specific to the database you’re using, we’ll cover that in the next section.

Make sure to set sessionCookie.expires to false.

// src/auth/lucia.ts
import { lucia } from "lucia";
import { web } from "lucia/middleware";

// expect error (see next section)
export const auth = lucia({
	env: process.env.NODE_ENV === "production" ? "PROD" : "DEV",
	middleware: web(),
	sessionCookie: {
		expires: false
	}
});

export type Auth = typeof auth;

Setup your database#

Lucia uses adapters to connect to your database. We provide official adapters for a wide range of database options, but you can always create your own. The schema and usage are described in each adapter’s documentation. The example below is for the Prisma adapter.

import { lucia } from "lucia";
import { web } from "lucia/middleware";
import { prisma } from "@lucia-auth/adapter-prisma";
import { PrismaClient } from "@prisma/client";

const client = new PrismaClient();

const auth = lucia({
	env: process.env.NODE_ENV === "production" ? "PROD" : "DEV",
	middleware: web(),
	sessionCookie: {
		expires: false
	},

	adapter: prisma(client)
});

Adapters for database drivers and ORMs#

• better-sqlite3: SQLite
• libSQL: libSQL (Turso)
• Mongoose: MongoDB
• mysql2: MySQL
• pg: PostgreSQL (including @neondatabase/serverless, @vercel/postgres)
• postgres: PostgreSQL
• Prisma: MongoDB, MySQL, PostgreSQL, SQLite
• Redis: Redis
• Unstorage: Azure, Cloudflare KV, Memory, MongoDB, Planetscale, Redis, Vercel KV

Provider specific adapters#

• Cloudflare D1
• PlanetScale serverless
• Upstash Redis

Using query builders#

• Drizzle ORM
• Kysely

Set up types#

In your src/app.d.ts file, declare a Lucia namespace. The import path for Auth is where you initialized lucia().

// src/app.d.ts
/// <reference types="lucia" />
declare namespace Lucia {
	type Auth = import("./auth/lucia").Auth;
	type DatabaseUserAttributes = {};
	type DatabaseSessionAttributes = {};
}

Polyfill#

If you’re using Node.js version 18 or below, you need to polyfill the Web Crypto API. This is not required if you’re using runtimes other than Node.js (Deno, Bun, Cloudflare Workers, etc) or using Node.js v20 and above.

// src/auth/lucia.ts
import { lucia } from "lucia";
import "lucia/polyfill/node";

export const auth = lucia({
	// ...
});

Optionally, instead of doing a side-effect import, add the --experimental-global-webcrypto flag when running next.

// package.json
{
	// ...
	"scripts": {
		"dev": "NODE_OPTIONS=--experimental-global-webcrypto solid-start dev",
		"build": "NODE_OPTIONS=--experimental-global-webcrypto solid-start build",
		"start": "NODE_OPTIONS=--experimental-global-webcrypto solid-start start"
		// ...
	}
	// ...
}

Next steps#

You can learn all the concepts and general APIs of Lucia by reading the Basics section in the docs. If you prefer writing code immediately, check out the Starter guides page or the examples repository.

Remember to check out the Guidebook for tutorials and guides! If you have any questions, join our Discord server!