# Deploy Legejo with Easypanel

URL: /templates/legejo

Legejo is a self-hosted library for your EPUB books. Upload books and they get their covers and details and land on shelves you arrange. Read them in the browser with highlights, notes and read-aloud, sync books, reading positions and highlights with a Kobo, connect reading apps such as KOReader or Thorium over OPDS, and keep KOReader's place in step. Several people can share one Legejo, each with a library of their own, and shelves of free books can be federated over ActivityPub and followed from Mastodon or another Legejo. Legejo also reads PDFs and comics in the browser, and keeps audiobooks. It runs on SQLite in a single container, so no database service is needed.

## Installation notes

Sign in with the admin username and the password in the service's Environment tab (LEGEJO_ADMIN_PASSWORD). The password is used only on the first start, to create the admin account. Mail, the public address and searching inside the books can be set up on Legejo's Admin page; these and the rest (single sign-on, the MCP server) are also listed in the Environment tab and described in the README.

## Benefits

### Your Books on Your Server

The whole library, database included, lives in one volume on your own server. No account elsewhere, no telemetry.

### Read Anywhere

Read in the browser, on a Kobo with books, positions and highlights in sync, or in any OPDS reading app such as KOReader or Thorium.

### Share and Federate

Share shelves with other users, give a shelf to someone on another Legejo with a private link, or federate shelves of free books over ActivityPub.

## Features

### Web Reader

A reader in the browser with highlights, notes, search in the book and read-aloud, that works offline once a book is saved on the device.

### Kobo Sync

Books, reading positions and highlights sync between Legejo and a Kobo e-reader.

### OPDS and KOReader

Reading apps connect over OPDS with an app password, and KOReader keeps its reading position in step with Legejo.

### PDFs, Comics and Audiobooks

Read PDFs and CBZ comics in the browser next to the EPUBs, and listen to audiobooks in the browser or as a podcast feed.

### Search Inside the Books

Switch it on on the Admin page to keep the text of the EPUBs in the database and search inside them, with phrases and passages that open the book at the match.

## Configuration

- `appServiceName` (App Service Name, required): legejo

- `appServiceImage` (App Service Image, required): slurvdjur/legejo:1.33.0

- `adminUser` (Admin Username, required): admin

## Services

- legejo: app (slurvdjur/legejo:1.33.0)

## Resources

- [Website](https://github.com/jularboolean/legejo)

- [Documentation](https://github.com/jularboolean/legejo#readme)

- [Github](https://github.com/jularboolean/legejo)

- [Template source](https://github.com/easypanel-io/templates/tree/main/templates/legejo)