diff --git a/README.md b/README.md
index 7696208..613593c 100644
--- a/README.md
+++ b/README.md
@@ -19,6 +19,14 @@ Add to `~/.config/paru/paru.conf`:
 Url = https://gitea.moonarch.de/nevaforget/moonarch-pkgbuilds
 ```
 
+Then sync the repository index:
+
+```bash
+paru -Sy --pkgbuilds
+```
+
+This downloads the PKGBUILDs from Gitea. Without this step, paru will not find the moonarch packages.
+
 ## Install
 
 ```bash
@@ -32,3 +40,14 @@ Standard system upgrade picks up new versions automatically:
 ```bash
 paru -Syu
 ```
+
+## Troubleshooting
+
+**"not downloaded (use -Sy --pkgbuilds to download)"**: Run `paru -Sy --pkgbuilds` to fetch the repo index.
+
+**"cannot update the lock file ... --locked was passed"**: The PKGBUILD cache is stale. Clear it and retry:
+
+```bash
+rm -rf ~/.cache/paru/clone/repo/moonarch
+paru -Sy --pkgbuilds && paru -S <package>
+```
diff --git a/moongreet-git/PKGBUILD b/moongreet-git/PKGBUILD
index 86fecdb..968d567 100644
--- a/moongreet-git/PKGBUILD
+++ b/moongreet-git/PKGBUILD
@@ -32,7 +32,7 @@ pkgver() {
 
 build() {
     cd "$srcdir/greetd-moongreet"
-    cargo build --release --locked
+    cargo build --release
 }
 
 package() {
diff --git a/moonlock-git/PKGBUILD b/moonlock-git/PKGBUILD
index 517f6a4..1e70831 100644
--- a/moonlock-git/PKGBUILD
+++ b/moonlock-git/PKGBUILD
@@ -36,7 +36,7 @@ pkgver() {
 
 build() {
     cd "$srcdir/moonlock"
-    cargo build --release --locked
+    cargo build --release
 }
 
 package() {