Robinson

Self-hosted management of the books in your personal library

Work in Progress

Self-hosted Book management for your personal library.

Add your bookcases, shelves and books. Track where they're stored, who they're loaned to and where you are.

Check your reading timeline and search your library. Easily add book by scanning they're ISBN.

Installation

If you're ready to self-host robinson yourself here's some steps to get started;

Install the docker engine on your OS of choice.

Create a docker-compose.yml file on your OS.

Copy the following in it.

services:
    mongo:
        image: mongo:latest
        restart: unless-stopped
        environment:
            MONGO_INITDB_ROOT_USERNAME: robinson
            MONGO_INITDB_ROOT_PASSWORD: robinson123
            MONGO_INITDB_DATABASE: robinson
        volumes:
            - robinson-data:/data/db
    robinson:
        image: ghcr.io/ryanmccartney/robinson:latest
        restart: unless-stopped
        environment:
            PORT: 80
            NODE_ENV: production
            DB_NAME: robinson
            DB_USER: robinson
            DB_PASSWORD: robinson123
            SESSION_SECRET: pleaseChangeMe
        depends_on:
            - mongo
        ports:
            - 80:80
volumes:
    robinson-data:

Please change your DB_PASSWORD and SESSION_SECRET for your own instance.

Run docker compose up -d.

Access robinson at http://localhost:80

Login with the default username admin and password robinson123

Development

• git clone https://github.com/ryanmccartney/robinson
• cd ./backend && npm i
• cd ./frontend && npm i
• docker compose up -d

Find the development frontend on http://localhost:3000 and self-documenting API backend at http://localhost:3100/api

Technology

• React fronted rolled with Webpack.
• Node.js and Express.js Backend
• Docker-based for easy self-hosting