Skip to content

Tin-Joy59/Librum-Server

 
 

Repository files navigation

Librum-Server

The Librum-Server includes the API, database, and other fundamental infrastructure required for the "backend" of all Librum client applications and the website.

The server is written in C# using ASP.NET Core. The codebase can be developed, built, run, and deployed cross-platform on Windows, macOS, and Linux.


Self-hosting

Librum-Server can easily be self-hosted. This way all your data and books remain on your own devices and are not synchronized to the official cloud.

There are two options for self-hosting Librum-Server:

  1. The first one is running a service on your linux server for which you can find instructions here.
  2. The other option is to run it via Docker which is described in the next section.

Running with Docker

Librum-Server can be run with Docker. We currently do not provide images in DockerHub so you'll need to build it yourself.

git clone https://github.com/Librum-Reader/Librum-Server
cd Librum-Server
docker build . -t librum

Librum will also need a database. You can use our sample docker-compose.yml file as a guide for setting it up.


Contributing

Feel free to reach out to us via email (contact@librumreader.com) or discord (m_david#0631) if you are interested in contributing.

We are following a pull request workflow where every contribution is sent as a pull request and merged into the dev/develop branch for testing. Please make sure to keep to the conventions used throughout the application and ensure that all tests pass, before submitting any pull request.

Releases

No releases published

Packages

 
 
 

Languages

  • C# 97.2%
  • HTML 1.3%
  • Other 1.5%