A simple web app to manage homelab docker services. I wrote this as portainer, Which i was using for managing my services on my homelab, Didn't have docker volume management i.e backup and restore and all the other docker volume backup and restore tools were too complicated for my needs.

Right now only supports volume backup and restore but I plan to add docker compose support and other features in the future.

• poetry
• docker
• python >=3.11

setup the project with poetry

# install dependencies
poetry install

create a .env file in the root of the project with the following content

# local directory to store backups
BACKUP_DIR=/path/to/repo/backup
# local directory to store the databases
DB_DIR=/path/to/repo/db
# the sqlalchemy url for the main database file
DATABASE_URL=sqlite:////path/to/repo//db/database.db
# the sqlalchemy url for the apschedule job store
APSCHEDULE_JOBSTORE_URL=sqlite:////path/to/repo/db/schedule.db

(Recommended way) This will start the app in a docker container with hot reloading and run a database migration on startup

# run the app
poe dev

you can also run it locally without docker, Which will run the same commands

# run the app
poe local-dev

Note: If you try to run the app locally with docker then using the same files for the database and backup directories as the container will cause permission issues. You will need to change the permissions of the files to allow the container to access them.

# run tests
poe test

To run black and isort on codebase:

# format the code
poe format

To run linting:

# lint the code
poe lint

To make it easy there is some poe tasks to run the migrations:

Run migrationthe

# run the migrations
poe migrate

Create a new migration revision

# create a new migration revision
poe revision "<revision message here>"

Rollback the last migration

# rollback the last migration
poe downgrade

To find out all options for tasks run poe --help

there is a example docker-compose file in the root of the project that you can use to run the app in production

See database.md for a diagram and explanation of the database structure

Copyright © 2023, Bob Bruce

This project is licensed under the GNU GPL v3+.

In short, this means you can do anything with it (distribute, modify, sell) but if you were to publish your changes, you must make the source code and build instructions readily available.

If you are a company using this project and want an exception, email me at [email protected] and we can discuss.