# Deploy BookOrbit with Easypanel

URL: /templates/bookorbit

BookOrbit is a self-hosted book management and reading tracker application. Organize your library, track reading progress, manage wishlists, and get AI-powered book recommendations — all on your own server.

## Installation notes

After deployment, open the app and complete the initial setup using your SETUP_BOOTSTRAP_TOKEN (shown in the service environment variables). Create your admin account during setup. The token is only needed once for the first login bootstrap.

## Benefits

### Self-Hosted Book Library

Keep full control of your reading data. BookOrbit runs entirely on your own server with no third-party data sharing.

### AI-Powered Recommendations

Get personalized book recommendations using built-in AI features powered by your reading history and preferences.

### Comprehensive Reading Tracker

Track currently reading, finished, and wishlist books with reading stats, progress updates, and collection management.

## Features

### Book Management

Organize books into shelves and collections with metadata, covers, and ratings.

### Reading Progress Tracking

Log reading sessions and track progress page-by-page across your entire library.

### Book Drop (Ingestion)

Drop book files into a watched folder for automatic ingestion into your library.

### PostgreSQL with pgvector

Uses pgvector for semantic search and AI recommendation capabilities.

## Configuration

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

- `appServiceImage` (App Service Image, required): ghcr.io/bookorbit/bookorbit:1.7.0

## Services

- bookorbit-db: postgres

- bookorbit: app (ghcr.io/bookorbit/bookorbit:1.7.0)

## Resources

- [Website](https://bookorbit.app)

- [Documentation](https://bookorbit.app/installation.html)

- [GitHub](https://github.com/bookorbit/bookorbit)

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