This project will not be developed any further. Any use is strongly discouraged.

This web project is intended to provide a collection of useful tools on topics related to a family or shared household. At present, only a household book is included, which can be used to record and categorize income and expenditure.

This project is still in the early stages of development and there is probably only one running installation out there... which is mine. Nevertheless, I take the project seriously and try to make it the best tool for managing our household.

Use a system-wide interpreter or create a virtual environment

Django requires a secret key to work. It's not recommended to hard-code it into the project's settings.py file. Instead, it should be provided either as an environment variable called SECRET_KEY or in a separate file called .secret_key.txt within the project's root directory:

echo '<my-secret-key>' > .secret_key.txt

pip install -r requirements.txt

./manage.py collectstatic

./manage.py migrate

./manage.py createsuperuser

./manage.py runserver 8000

Warning: This should only be started within a trusted and secure environment. Expect that this container is not safe and will likely have security issues which could be exploited by an attacker.

docker pull docker.pkg.github.com/cupracer/family-tools/family-tools:latest

Attention: Please note that you'll lose your database if the container is destroyed (see below for persistent storage)!

Replace <my-secret> with a real secret key.

docker run -it -e SECRET_KEY='<my-secret>' docker.pkg.github.com/cupracer/family-tools/family-tools:latest

-e ALLOWED_HOSTS="['some.host.name', 'some.ip']"

-v /path/to/persistent/db.sqlite3:/opt/family-tools/db.sqlite3

docker exec -it my-container ./manage.py createsuperuser

Login to the admin interface as superuser

http://<your-application>:8000/admin/

and create one or more users.

Make sure to add them to the group "members" to enable them for this application.