Skip to content

Commit e4213c2

Browse files
committed
docs: add migration guide for v1.2.0
1 parent a066a73 commit e4213c2

File tree

1 file changed

+17
-0
lines changed

1 file changed

+17
-0
lines changed

web/project-site/src/docs/Installation.mdx

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,23 @@
22

33
Get Scriberr running on your system in a few minutes.
44

5+
## Migrating from v1.1.0
6+
7+
If you are upgrading from v1.1.0, please follow these steps to ensure a smooth transition. Version 1.2.0 introduces a separation between application data (database, uploads) and model data (Python environments).
8+
9+
### 1. Update Volume Mounts
10+
11+
You will need to update your Docker volume configuration to split your data:
12+
13+
* **Application Data:** Bind your existing data folder (containing `scriberr.db`, `jwt_secret`, `transcripts/`, and `uploads/`) to `/app/data`.
14+
* **Model Environment:** Create a **new, empty folder** and bind it to `/app/whisperx-env`.
15+
16+
### 2. Clean Up Old Environments
17+
18+
> **CRITICAL:** You must delete any existing `whisperx-env` folder from your previous installation.
19+
20+
The Python environment and models need to be reinitialized for v1.2.0. If the application detects an old environment, it may attempt to use it, leading to compatibility errors. Starting with a fresh `/app/whisperx-env` volume ensures the correct dependencies are installed.
21+
522
## Install with Homebrew (macOS & Linux)
623

724
The easiest way to install Scriberr is using Homebrew. If you don’t have Homebrew installed, [get it here first](https://brew.sh/).

0 commit comments

Comments
 (0)