tailscale-dev / tailscale-dev/ScaleTail

⚡️ Feature: (DOCS) Use compose.overrides.yaml, and don't store volumes in git repo.

Open
#317 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

enhancement
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.yaml instead of editing the main file
  • Update compose.yaml files 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

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.