# I, Librarian •

[I, Librarian](https://i-librarian.net/) is a self-hosted service for organizing and searching your academic research.

# Overview

[![Screen Shot 2025-03-09 at 23.59.59.png](https://hub.subspace.services/uploads/images/gallery/2025-03/scaled-1680-/screen-shot-2025-03-09-at-23-59-59.png)](https://hub.subspace.services/uploads/images/gallery/2025-03/screen-shot-2025-03-09-at-23-59-59.png)

[I, Librarian](https://i-librarian.net/) is a self-hosted service for organizing and searching your academic research.

<p class="callout success">Tryout an [I, Librarian demo](https://i-librarian.net/demo).</p>

- Build a centralized repository for all of your academic research and organize your paper metadata.
- Leverage full-text search for your entire library and find just the paper you need.
- Collaborate with peers directly your your browser with features like user accounts, discussion boards and project management.

# Media

## Screenshots

<p class="callout info">I, Librarian v5.11.2</p>

<table border="1" id="bkmrk-" style="border-collapse: collapse; width: 100%; border-width: 1px; height: 59.6px; border-color: rgb(88, 110, 117);"><colgroup><col style="width: 33.3333%;"></col><col style="width: 33.3333%;"></col><col style="width: 33.3333%;"></col></colgroup><tbody><tr style="height: 29.8px;"><td style="border-width: 1px; height: 29.8px; border-color: rgb(88, 110, 117);">[![Screen Shot 2025-03-09 at 23.59.59.png](https://hub.subspace.services/uploads/images/gallery/2025-03/scaled-1680-/screen-shot-2025-03-09-at-23-59-59.png)](https://hub.subspace.services/uploads/images/gallery/2025-03/screen-shot-2025-03-09-at-23-59-59.png)</td><td style="border-width: 1px; height: 29.8px; border-color: rgb(88, 110, 117);">[![Screen Shot 2025-03-10 at 00.00.13.png](https://hub.subspace.services/uploads/images/gallery/2025-03/scaled-1680-/screen-shot-2025-03-10-at-00-00-13.png)](https://hub.subspace.services/uploads/images/gallery/2025-03/screen-shot-2025-03-10-at-00-00-13.png)</td><td style="border-width: 1px; height: 29.8px; border-color: rgb(88, 110, 117);">[![Screen Shot 2025-03-10 at 00.00.40.png](https://hub.subspace.services/uploads/images/gallery/2025-03/scaled-1680-/screen-shot-2025-03-10-at-00-00-40.png)](https://hub.subspace.services/uploads/images/gallery/2025-03/screen-shot-2025-03-10-at-00-00-40.png)</td></tr><tr style="height: 29.8px;"><td style="border-width: 1px; height: 29.8px; border-color: rgb(88, 110, 117);">[![Screen Shot 2025-03-10 at 00.01.08.png](https://hub.subspace.services/uploads/images/gallery/2025-03/scaled-1680-/screen-shot-2025-03-10-at-00-01-08.png)](https://hub.subspace.services/uploads/images/gallery/2025-03/screen-shot-2025-03-10-at-00-01-08.png)</td><td style="border-width: 1px; height: 29.8px; border-color: rgb(88, 110, 117);">[![Screen Shot 2025-03-10 at 00.01.25.png](https://hub.subspace.services/uploads/images/gallery/2025-03/scaled-1680-/screen-shot-2025-03-10-at-00-01-25.png)](https://hub.subspace.services/uploads/images/gallery/2025-03/screen-shot-2025-03-10-at-00-01-25.png)</td><td style="border-width: 1px; height: 29.8px; border-color: rgb(88, 110, 117);">[![Screen Shot 2025-03-10 at 00.01.39.png](https://hub.subspace.services/uploads/images/gallery/2025-03/scaled-1680-/screen-shot-2025-03-10-at-00-01-39.png)](https://hub.subspace.services/uploads/images/gallery/2025-03/screen-shot-2025-03-10-at-00-01-39.png)</td></tr><tr><td style="border-width: 1px; border-color: rgb(88, 110, 117);">[![Screen Shot 2025-03-10 at 00.01.46.png](https://hub.subspace.services/uploads/images/gallery/2025-03/scaled-1680-/screen-shot-2025-03-10-at-00-01-46.png)](https://hub.subspace.services/uploads/images/gallery/2025-03/screen-shot-2025-03-10-at-00-01-46.png)</td><td style="border-width: 1px; border-color: rgb(88, 110, 117);">  
</td><td style="border-width: 1px; border-color: rgb(88, 110, 117);">  
</td></tr></tbody></table>

# Setup & Configuration

We need to install the service through Portainer and configure any necessary settings.

# Preparation

There are some things we need to do in preparation to install this service.

## Volumes

<details id="bkmrk-media-folders-radarr"><summary>Persistent Data</summary>

This is where the service will store its own application data and ensures we can quickly update the service image.

<p class="callout warning">Ensure your user has permissions to access the folder.</p>

</details>

# Installation

The service can be installed through the Portainer web interface.

<p class="callout info">Learn about [creating a new stack](https://hub.subspace.services/books/portainer/page/creating-a-new-stack "Creating a New Stack").</p>

## Docker Compose

Use the following code to install the service:

```yaml
---
services:
  i-librarian:
    image: cgrima/i-librarian
    ports:
      - "2485:80"
    volumes:
      # Persistent Data
      - /srv/ilibrarian/:/app/data

      # Local Time for Container
      - /etc/localtime:/etc/localtime:ro
```

# Updating

<p class="callout success">Re-Deploy the Stack</p>

This service has been optimized for running in Docker.

This allows you to [re-deploy the stack through Portainer](https://hub.subspace.services/books/portainer/page/updating-a-stack "Updating a Stack") to download the latest updates.

# User Manual

# Development

<p class="callout info">This software is released under the [GPL-3.0 license](https://opensource.org/license/gpl-3-0). </p>

You can learn more about how to contribute to I, Librarian by submitting issue requests through their [documentation](https://github.com/mkucej/i-librarian-free/issues).

# Resources

## Official

- [Official GitHub Repository](https://github.com/mkucej/i-librarian-free)
- [Official Website](https://i-librarian.net/)
- [Installation Guide](https://github.com/mkucej/i-librarian-free/blob/master/README-Linux.md)
- [General Troubleshooting](https://i-librarian.net/support)