From 6f25ce0fd56538e7ca25e4c6ad9fca7385e217c9 Mon Sep 17 00:00:00 2001
From: Mikhail <mikhail@liamets.dev>
Date: Thu, 23 May 2024 20:12:27 +0200
Subject: [PATCH] Add info on migrations

---
 docs/running.md | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/docs/running.md b/docs/running.md
index 74b4c60..53ffa84 100644
--- a/docs/running.md
+++ b/docs/running.md
@@ -67,3 +67,35 @@ Or you can build it and run manually:
 
     cargo build --release
     ./target/release/lavina --config config.toml
+
+
+## Migrations
+
+### Prerequisites
+
+Install sqlx-cli into ~/.local/bin:
+
+    cargo install --locked sqlx-cli
+
+### Steps
+
+Migrations run on every application start. For manual run, use sqlx:
+
+    sqlx mig run \
+        --source ./crates/lavina-core/migrations/ \
+        --database-url sqlite://db.sqlite
+
+To see current status:
+
+    sqlx mig info \
+        --source ./crates/lavina-core/migrations/ \
+        --database-url sqlite://db.sqlite
+
+sqlx mig info outputs
+
+    0/installed first
+    1/installed msg author
+    2/installed created at for messages
+    3/installed dialogs
+    4/installed new challenges
+    5/pending message datetime