docker-composer/README.md

31 lines
1.5 KiB
Markdown
Raw Normal View History

2022-12-11 22:15:32 -06:00
# Docker Composer
2022-12-29 23:12:53 -06:00
This is a simple program to manage docker containers. It works similarly to Umbrel's scripts, but is not limited to Umbrel. It's really just for convenience.
2022-12-11 22:15:32 -06:00
## How to use
2022-12-14 13:32:40 -06:00
- **Note:** All scrips must be run in the same directory as the `docker-composer.conf` file.
2022-12-13 19:45:38 -06:00
- If you want to re-compose your containers on boot, you can run `composer.py` on boot
2022-12-14 10:48:51 -06:00
- If you want to re-compose your containers on demand, you can run `re_compose.py` manually
2022-12-11 22:15:32 -06:00
- If you just want to do basic management, like stopping, starting, removing docker containers, etc, then use `basic-management.py`. It's essentially an interactive wrapper for the basics of docker.
## Installation
2022-12-16 21:15:13 -06:00
Just put these scripts somewhere, and run them as needed. Remember to edit the `docker-composer.conf` file to your needs - parameters below, in [Usage](https://github.com/askiiart/docker-composer/edit/master/README.md#usage)
2022-12-14 13:32:40 -06:00
2022-12-11 22:15:32 -06:00
## Usage
2022-12-14 13:32:40 -06:00
`docker-composer.conf` parameters:
2022-12-11 22:15:32 -06:00
- `compose-path`: The path to the folder containing the folders for each docker container - the folder for each container includes a `docker-compose.yml` file.
2022-12-16 21:16:57 -06:00
- `exclude-containers`: A list of containers to exclude from being managed by the program. This will stop the scripts (except `basic_management.py`) from doing **anything** to those containers.
2022-12-11 22:15:32 -06:00
2022-12-14 13:32:40 -06:00
Notes:
- The folders *must* have the same name as their respective docker containers
2022-12-16 07:22:10 -06:00
- Remember to run the script as a user that can access Docker engine
2022-12-14 13:32:40 -06:00
2022-12-11 22:15:32 -06:00
2022-12-14 10:48:51 -06:00
## Status
2022-12-16 07:22:10 -06:00
- All scripts are complete and working! Feel free to use this now.