diff --git a/apps/docs/content/guides/deployment/database-migrations.mdx b/apps/docs/content/guides/deployment/database-migrations.mdx
index c3816014366..5587e784f7f 100644
--- a/apps/docs/content/guides/deployment/database-migrations.mdx
+++ b/apps/docs/content/guides/deployment/database-migrations.mdx
@@ -15,6 +15,16 @@ For this guide, we'll create a table called `employees` and see how we can make
 
 You will need to [install](/docs/guides/local-development#quickstart) the Supabase CLI and start the local development stack.
 
+<Admonition type="tip">
+
+If a lock timeout error occurs, in your migration file, consider increasing you [`lock_timeout`](https://postgresqlco.nf/doc/en/param/lock_timeout/) setting:
+
+```sql
+SET lock_timeout = '2min';
+```
+
+</Admonition>
+
 <StepHikeCompact>
 
   <StepHikeCompact.Step step={1}>