tailscale-dev / tailscale-dev/ScaleTail
⚡️ Feature: (DOCS) Use compose.overrides.yaml, and don't store volumes in git repo.
Nobody has claimed this yet.
- Dominant language
- Python
- Stars
- 2.1k
- Forks
- 124
- Avg merge
- 1d 19h
- Merged PRs (30d)
- 4
Description
Feature Description
Update docs and default compose.yaml files to:
- Use
compose.overrides.yaml - only bind folders outside the git repo
Problem It Solves
Currently the instructions are to clone the repo, cd to a service, edit compose.yaml and .env.
However this leads to problems when updating the repo (e.g. to use newly added services).
Furthermore it's complicated to use branches because of permission issues with container data stored directly in the repo directories.
Proposed Solution
- Update docs to suggest using
compose.overrides.yamlinstead of editing the main file - Update
compose.yamlfiles in order to store volumes outside the git repo (could be something like ${HOME}/scaletale-data/${SERVICE} or similar)
Could even use https://specifications.freedesktop.org/basedir/latest/ but that might be overkill
With this setup you can happily keep using git pull to pull updates and add additional services if needed.
Would you be willing to work on this feature?
- Yes, I'd like to implement this feature
- I could help with parts of this feature
- No, I'm just suggesting the feature
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by locating the repository’s documentation and default compose.yaml files, then review how current instructions use compose.yaml, .env, and bind-mounted volumes. Update the documented workflow around compose.overrides.yaml and ensure the default volume paths are outside the git repository. Done means the docs and compose configurations support git pulls, branches, and newly added services without editing tracked files or storing container data in the repository.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- docker, docker-compose
- Domain
- devops, documentation, infrastructure
- Issue type
- Feature
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 55/100