summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorPhilippe Normand <phil@base-art.net>2024-01-23 10:13:53 +0000
committerGitHub <noreply@github.com>2024-01-23 10:13:53 +0000
commited1ac5a2a9cb89cd2364e499188aa122f1b94664 (patch)
tree979ca4b3feb36ffc05e93e8d039c7cfcb47a1e37
parentd84f5b2d33e1e6d69877facf037bff02b231ae3c (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.md15
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!