diff options
author | Philippe Normand <phil@base-art.net> | 2024-01-23 10:13:53 +0000 |
---|---|---|
committer | GitHub <noreply@github.com> | 2024-01-23 10:13:53 +0000 |
commit | ed1ac5a2a9cb89cd2364e499188aa122f1b94664 (patch) | |
tree | 979ca4b3feb36ffc05e93e8d039c7cfcb47a1e37 | |
parent | d84f5b2d33e1e6d69877facf037bff02b231ae3c (diff) |
docs: Mention environment variables for custom paths (#1614)
Thanks to Ellie and Pete's help on this forum post:
https://forum.atuin.sh/t/migration-was-previously-applied-but-is-missing-in-the-resolved-migrations/84
-rw-r--r-- | CONTRIBUTING.md | 15 |
1 files changed, 15 insertions, 0 deletions
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 066e9671..6a60d077 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -6,6 +6,21 @@ Atuin doesn't require anything super special to develop - standard Rust tooling Before working on anything, we suggest taking a copy of your Atuin data directory (`~/.local/share/atuin` on most \*nix platforms). If anything goes wrong, you can always restore it! +While data directory backups are always a good idea, you can instruct Atuin to use custom path using the following environment variables: + +```shell +export ATUIN_DB_PATH=/tmp/atuin_dev.db +export ATUIN_RECORD_STORE_PATH=/tmp/atuin_records.db +``` + +It is also recommended to update your `$PATH` so that the pre-exec scripts would use the locally built version: + +```shell +export PATH="./target/release:$PATH" +``` + +These 3 variables can be added in a local `.envrc` file, read by [direnv](https://direnv.net/). + ## What to work on? Any issues labeled "bug" or "help wanted" would be fantastic, just drop a comment and feel free to ask for help! |