client/container/repo: change layout of default paths (environment, bind-mounts) #301

AaronFiore · 2026-02-18T18:58:38Z

AaronFiore commented

2026-02-18 18:58:38 +00:00

Description

🚨 Requires manual intervention

Defaults are now consolidated under a single parent directory
Basenames are now simply-named to avoid verbosity and confusion
- Assumes that installation instructions were used during setup (see EvergreenCrypto/dfi-docs#9)

For smoothest transition:

Create a parent umbrella directory called ./docker-finance
Rename (or symlink) your existing docker-finance repository (DOCKER_FINANCE_CLIENT_REPO) to a directory called repo and move repo into ./docker-finance (will now be ./docker-finance/repo)
Move (or symlink) configuration directory (DOCKER_FINANCE_CLIENT_CONF) into ./docker-finance, rename docker-finance.d to conf.d (will now be ./docker-finance/conf.d)
Move (or symlink) your finance-flow directory (DOCKER_FINANCE_CLIENT_FLOW) into ./docker-finance, rename finance-flow to flow (will now be ./docker-finance/flow)
Within your ./docker-finance/flow/profiles directory, rename all subprofile docker-finance.d directories to conf.d
Move (or symlink) your custom plugins directory (DOCKER_FINANCE_CLIENT_PLUGINS) into ./docker-finance (will now be ./docker-finance/plugins)
Move (or symlink) your share.d directory (DOCKER_FINANCE_CLIENT_SHARED) into ./docker-finance (will now be ./docker-finance/share.d)
Manually update your conf.d environment files for all platforms and tags to reflect the new client-side locations (e.g., ./docker-finance/conf.d/client/Linux-x86_64/archlinux/default/env/username@localhost.localdomain)
Manually update your superscript.bash, changing docker-finance.d to conf.d where applicable (e.g., $ sed -i 's:/docker-finance.d/:/conf.d/:g' ./docker-finance/conf.d/container/shell/superscript.bash)
Remove all docker-finance related aliases and completion source from ~/.bashrc (or ~/.bash_aliases)
Re-run install: ./docker-finance/repo/client/install.bash && source ~/.bashrc
Optional Re-run gen type=env to get the new container-side bind-mount locations (e.g., dfi archlinux/${USER}:default gen type=env confirm=no)

🥳 Your defaults can now be changed and paths moved/renamed as you please: simply update your environment file in conf.d (e.g., dfi archlinux/${USER}:default edit type=env)

⚠ If changing the expected repository location, you'll need to manually update the conf.d environment file as well as your aliases/source (~/.bashrc)

Agreement

I have read and understood the Development and License documentation

### Description 🚨 Requires manual intervention - Defaults are now consolidated under a single parent directory - Basenames are now simply-named to avoid verbosity and confusion * Assumes that installation instructions were used during setup (see https://gitea.evergreencrypto.co/EvergreenCrypto/dfi-docs/pulls/9) For smoothest transition: 1. Create a parent umbrella directory called `./docker-finance` 2. Rename (or symlink) your existing `docker-finance` repository (`DOCKER_FINANCE_CLIENT_REPO`) to a directory called `repo` and move `repo` into `./docker-finance` (will now be `./docker-finance/repo`) 3. Move (or symlink) configuration directory (`DOCKER_FINANCE_CLIENT_CONF`) into `./docker-finance`, rename `docker-finance.d` to `conf.d` (will now be `./docker-finance/conf.d`) 4. Move (or symlink) your `finance-flow` directory (`DOCKER_FINANCE_CLIENT_FLOW`) into `./docker-finance`, rename `finance-flow` to `flow` (will now be `./docker-finance/flow`) 5. Within your `./docker-finance/flow/profiles` directory, rename all subprofile `docker-finance.d` directories to `conf.d` 6. Move (or symlink) your custom `plugins` directory (`DOCKER_FINANCE_CLIENT_PLUGINS`) into `./docker-finance` (will now be `./docker-finance/plugins`) 7. Move (or symlink) your `share.d` directory (`DOCKER_FINANCE_CLIENT_SHARED`) into `./docker-finance` (will now be `./docker-finance/share.d`) 8. Manually update your `conf.d` environment files for all platforms and tags to reflect the new client-side locations (e.g., `./docker-finance/conf.d/client/Linux-x86_64/archlinux/default/env/username@localhost.localdomain`) 9. Manually update your `superscript.bash`, changing `docker-finance.d` to `conf.d` where applicable (e.g., `$ sed -i 's:/docker-finance.d/:/conf.d/:g' ./docker-finance/conf.d/container/shell/superscript.bash`) 10. Remove all docker-finance related aliases and completion source from `~/.bashrc` (or `~/.bash_aliases`) 11. Re-run install: `./docker-finance/repo/client/install.bash && source ~/.bashrc` 12. *Optional* Re-run `gen type=env` to get the new container-side bind-mount locations (e.g., `dfi archlinux/${USER}:default gen type=env confirm=no`) 🥳 Your defaults can now be changed and paths moved/renamed as you please: simply update your environment file in `conf.d` (e.g., `dfi archlinux/${USER}:default edit type=env`) - ⚠ If changing the expected repository location, you'll need to manually update the `conf.d` environment file as well as your aliases/source (`~/.bashrc`) ### Agreement - [x] I have read and understood the [Development](https://gitea.evergreencrypto.co/EvergreenCrypto/dfi-docs/src/branch/master/markdown/How-do-I-contribute.md#development) and [License](https://gitea.evergreencrypto.co/EvergreenCrypto/dfi-docs/src/branch/master/markdown/Where-is-the-legalese.md#where-is-the-legalese) documentation

AaronFiore added this to the v1.3.0 milestone 2026-02-18 18:58:38 +00:00

AaronFiore added the client/docker (src)Breaking client/docker-finance.d container/finance Language/YAML Repository Language/Bash Tests labels 2026-02-18 18:58:38 +00:00

AaronFiore added 6 commits 2026-02-18 18:58:38 +00:00

client: docker-finance.d: env: change default paths 03f43f407f

- Defaults are now consolidated under a single parent directory
- Basenames are now simply-named to avoid verbosity and confusion
  * Assumes that installation instructions were used during setup

client: lib_env: change docker-finance.d to conf.d dd66992932

client: lib_gen: change docker-finance.d to conf.d 489d7019ee

container: lib_finance: change docker-finance.d to conf.d 8dc028b393

client: move docker-finance.d to conf.d 4d6a41a38a

repo: gitea: workflows: dfi: update to reflect default paths 7c9f678c25

AaronFiore changed title from ~~client/container/repo: change layout of default paths (environment, bind-mounts)~~ to WIP: client/container/repo: change layout of default paths (environment, bind-mounts)

2026-02-18 19:19:58 +00:00

AaronFiore changed title from ~~WIP: client/container/repo: change layout of default paths (environment, bind-mounts)~~ to client/container/repo: change layout of default paths (environment, bind-mounts)

2026-02-18 20:02:32 +00:00

AaronFiore referenced this issue from a commit

2026-02-18 21:36:30 +00:00

Merge pull request #301 into master

AaronFiore manually merged commit 699c838214 into master

2026-02-18 21:36:57 +00:00

AaronFiore referenced this pull request

2026-02-19 02:16:56 +00:00

client: fix base path location deduction when sourced #303

AaronFiore referenced this issue from a commit

2026-02-19 19:26:30 +00:00

client: fix base path location deduction when sourced