diff --git a/.code-workspace b/.code-workspace index b05996a..3556464 100644 --- a/.code-workspace +++ b/.code-workspace @@ -11,6 +11,7 @@ "**/*.json": true, "node_modules": true, "lib": true - } + }, + "ansible.python.interpreterPath": "/bin/python3" } } \ No newline at end of file diff --git a/README.md b/README.md index d78a904..e6664dd 100644 --- a/README.md +++ b/README.md @@ -1,21 +1,18 @@ # homesrv01.dev.lan -Welcome to homesrv01.dev.lan git page. +Welcome to my home server repository, where Home Assistant and other services are hosted. +This repository is dedicated to documenting and maintaining the server configuration and workflows. -This repository serves to document and maintain the server where the home assistant runs. +The primary goal is to establish a Docker-based server capable of isolating services and communications related to home automation at the network level. +The server operates within its own VLAN (`homesrv`) but requires controlled communication with other VLANs, such as: -The goal was to create a server with docker where it would be possible to isolate, services and communications related to home automation at network level. - -The server itself is on its own vlan (Vlan: homesrv) but requires communication with the others Vlans: - -- IOT +- **IOT** ## Table of Contents - [Services](#services) - [myInfra stack](#myinfra-stack) - - [SSH](#ssh) - [nginx](#nginx) - [Home Assistant](#home-assistant) - [Lyrion Music Server (LMS)](#lyrion-music-server-lms) @@ -33,11 +30,7 @@ The server itself is on its own vlan (Vlan: homesrv) but requires communication ### myInfra stack -docker, Portainer, promtail and telegraf [maintained on myInfra repo](/marcio.fernandes&myInfra). - -### SSH - -Deployed and maintained by ansible role [myInfra.dev.homesrv1](#ansible-roles). +docker, promtail and telegraf [maintained on myInfra repo](/marcio.fernandes/myInfra). ### nginx @@ -51,9 +44,15 @@ All sites configurations set during docker build. ### Lyrion Music Server (LMS) -[Check git repo](/marcio.fernandes/lms) for more information how to setup Lyrion Music Server docker container. Or [git repo](/marcio.fernandes/homeassistant#squeezebox-lyrion-music-server) for more information about home assistant integration. +For instructions on setting up the Lyrion Music Server Docker container, refer to the [LMS Git Repository](/marcio.fernandes/lms). +For information on integrating Lyrion Music Server with Home Assistant, visit the [Home Assistant Git Repository](/marcio.fernandes/homeassistant#squeezebox-lyrion-music-server). -Requires [docker plugin rclone and s3 bucket volume](#myinfradevhomesrv01). +Using [Docker Rclone plugin](https://rclone.org/docker/) for accessing the bucket where music is stored. Configuration is managed via [Ansible playbook](./rclone.docker-plugin.playbook.yml). + +```sh +#configure access to s3 bucket +ansible-playbook ./rclone.docker-plugin.playbook.yml +``` ### Mosquitto @@ -185,10 +184,10 @@ Codename: noble Using visual studio code, docker, ansible and gitea actions. ### Docker context - - ```bash - # create context to homesrv01 docker on development devices - docker context create homesrv01 --docker host=ssh://admin@homesrv01.dev.lan + +```bash +# create context to homesrv01 docker on development devices +docker context create homesrv01 --docker host=ssh://admin@homesrv01.dev.lan ``` ```bash @@ -200,9 +199,9 @@ journalctl -r -t auto-update ### rclone plugin - +[https://rclone.org/docker/](https://rclone.org/docker/) -``` bash +```bash sudo apt-get -y install fuse docker plugin install rclone/docker-volume-rclone:amd64 args="-v" --alias rclone --grant-all-permissions diff --git a/setup.rclone.docker-plugin.playlist.yml b/rclone.docker-plugin.playbook.yml similarity index 75% rename from setup.rclone.docker-plugin.playlist.yml rename to rclone.docker-plugin.playbook.yml index bf32806..85116dc 100644 --- a/setup.rclone.docker-plugin.playlist.yml +++ b/rclone.docker-plugin.playbook.yml @@ -1,5 +1,13 @@ - name: Setup rclone docker plugin become: true + vars: + rclone_docker_plugin_config: | + [s3-limbo-storage] + type = s3 + provider = SeaweedFS + access_key_id = !!! SET ON INVENTORY !!! + secret_access_key = !!! SET ON INVENTORY !!! + endpoint = !!! SET ON INVENTORY !!! hosts: - homesrv01