HomeBook.Client 1.0.75

HomeBook

HomeBook is a self-hosted web application for organizing household tasks and joint financial planning. Developed for families, it creates structure, transparency, and collaboration in everyday life. Easily deployable on your own server via Docker.

✨ Features

• ✅ Collaborative household task management
• 💰 Budget planning and expense tracking
• 👨‍👩‍👧‍👦 Family-friendly user interface
• 🔒 Fully self-hosted – keep your data private
• 🐳 Easy deployment via Docker

🚀 Quick Start

Requirements

• Docker & Docker Compose
• Optional: your own server or Raspberry Pi

Installation via Docker & nginx Proxy Manager

add to Docker Compose

services:
  homebook:
    image: lkcode/homebook:latest
    container_name: homebook
    restart: unless-stopped
    volumes:
        - homebook-data:/var/lib/homebook

volumes:
    homebook-data:

add to nginx proxy manager

1. Create a new proxy host in Nginx Proxy Manager
2. Set the domain name (e.g., my-homebook.mydomain.com)
3. Set the scheme to http
4. Set the forward hostname to homebook (must be the same as the container name)
5. Set the forward port to 8080
6. disable Cache Assets
7. enable Block Common Exploits
8. enable Websockets Support

open your domain and you should see the HomeBook Setup.

Installation via CasaOS

coming soon...

Setup

1. Server Connection Check - the server checks that all required dependencies are installed and that no setup is currently running.
2. Admin User - create the first admin user with a username, password, and email address.
3. Database Setup - configure the database connection and check the connection.
4. Configuration - configure the application settings, such as the homebook instance name and language.

User Guide

Environment Variables

if all environment variables are set, correctly, the setup will be running automatically.

Allowed Password Characters

a-z
A-Z
0-9
!@#$%^&*()_+-=[]{}|;':",./<>?~`

Optional Docker Settings

Bind Volume to Host

1. Create a directory on your host machine to store HomeBook data, e.g., mkdir -p /your/path/homebook.
2. Execute command to set rights chown -R 21001 /your/path/homebook && chmod -R 770 /your/path/homebook (21001 is the standard homebook user-id for docker, replace if needed).
3. Modify your Docker Compose file to bind the volume to the host directory:

services:
  homebook:
    ...
    volumes:
      - /host/path/homebook:/var/lib/homebook