Merge pull request #7444 from Matthew-Wise/main

eshanrnh · web-flow · commit 3faacf09aaca · 2025-09-29T13:32:48.000+02:00
Updated SQLite Cache
diff --git a/10/umbraco-cms/fundamentals/setup/install/unattended-install.md b/10/umbraco-cms/fundamentals/setup/install/unattended-install.md
@@ -47,7 +47,7 @@ It is recommended that you make use of the values shown below for the `Cache`, `
 ```json
 {
   "ConnectionStrings": {
-    "umbracoDbDSN": "Data Source=|DataDirectory|/Umbraco.sqlite.db;Cache=Private;Foreign Keys=True;Pooling=True",
+    "umbracoDbDSN": "Data Source=|DataDirectory|/Umbraco.sqlite.db;Cache=Shared;Foreign Keys=True;Pooling=True",
     "umbracoDbDSN_ProviderName": "Microsoft.Data.SQLite"
   }
 }
diff --git a/10/umbraco-cms/reference/configuration/connectionstringssettings.md b/10/umbraco-cms/reference/configuration/connectionstringssettings.md
@@ -12,14 +12,14 @@ An connection strings config can look like this:
 ```json
 {
   "ConnectionStrings": {
-    "umbracoDbDSN": "Data Source=|DataDirectory|/Umbraco.sqlite.db;Cache=Private;Foreign Keys=True;Pooling=True",
+    "umbracoDbDSN": "Data Source=|DataDirectory|/Umbraco.sqlite.db;Cache=Shared;Foreign Keys=True;Pooling=True",
     "umbracoDbDSN_ProviderName": "Microsoft.Data.SQLite"
   }
 }
 ```
 
 {% hint style="info" %}
-We recommend using private cache for SQLite. You can read more on why shared cache is discouraged in [the official SQLite documentation](https://sqlite.org/sharedcache.html).
+We recommend using shared cache for SQLite when using Umbraco, as it provides better performance and consistency when multiple connections may access the database simultaneously.
 {% endhint %}
 
 The connection string used here is an SQLite connection string, that will connect to a data in the file `Umbraco.sqlite.db` located in `/umbraco/Data` .
diff --git a/10/umbraco-commerce/how-to-guides/configure-sqlite-support.md b/10/umbraco-commerce/how-to-guides/configure-sqlite-support.md
@@ -34,9 +34,9 @@ After configuring Umbraco CMS with SQLite, Umbraco Commerce will automatically u
 {
     ...
     "ConnectionStrings": {
-        "umbracoDbDSN": "Data Source=|DataDirectory|/Umbraco.sqlite.db;Cache=Private;Foreign Keys=True;Pooling=True",
+        "umbracoDbDSN": "Data Source=|DataDirectory|/Umbraco.sqlite.db;Cache=Shared;Foreign Keys=True;Pooling=True",
         "umbracoDbDSN_ProviderName": "Microsoft.Data.SQLite",
-        "umbracoCommerceDbDSN": "Data Source=|DataDirectory|/Umbraco.Commerce.sqlite.db;Mode=ReadWrite;Foreign Keys=True;Pooling=True;Cache=Private",
+        "umbracoCommerceDbDSN": "Data Source=|DataDirectory|/Umbraco.Commerce.sqlite.db;Mode=ReadWrite;Foreign Keys=True;Pooling=True;Cache=Shared",
         "umbracoCommerceDbDSN_ProviderName": "Microsoft.Data.SQLite"
     },
     ...
diff --git a/13/umbraco-cms/fundamentals/setup/install/unattended-install.md b/13/umbraco-cms/fundamentals/setup/install/unattended-install.md
@@ -47,7 +47,7 @@ It is recommended that you make use of the values shown below for the `Cache`, `
 ```json
 {
   "ConnectionStrings": {
-    "umbracoDbDSN": "Data Source=|DataDirectory|/Umbraco.sqlite.db;Cache=Private;Foreign Keys=True;Pooling=True",
+    "umbracoDbDSN": "Data Source=|DataDirectory|/Umbraco.sqlite.db;Cache=Shared;Foreign Keys=True;Pooling=True",
     "umbracoDbDSN_ProviderName": "Microsoft.Data.SQLite"
   }
 }
diff --git a/13/umbraco-cms/reference/configuration/connectionstringssettings.md b/13/umbraco-cms/reference/configuration/connectionstringssettings.md
@@ -11,14 +11,14 @@ An connection strings config can look like this:
 ```json
 {
   "ConnectionStrings": {
-    "umbracoDbDSN": "Data Source=|DataDirectory|/Umbraco.sqlite.db;Cache=Private;Foreign Keys=True;Pooling=True",
+    "umbracoDbDSN": "Data Source=|DataDirectory|/Umbraco.sqlite.db;Cache=Shared;Foreign Keys=True;Pooling=True",
     "umbracoDbDSN_ProviderName": "Microsoft.Data.SQLite"
   }
 }
 ```
 
 {% hint style="info" %}
-We recommend using private cache for SQLite. You can read more on why shared cache is discouraged in [the official SQLite documentation](https://sqlite.org/sharedcache.html).
+We recommend using shared cache for SQLite when using Umbraco, as it provides better performance and consistency when multiple connections may access the database simultaneously.
 {% endhint %}
 
 The connection string used here is an SQLite connection string, that will connect to a data in the file `Umbraco.sqlite.db`  located in `/umbraco/Data` .
diff --git a/13/umbraco-commerce/how-to-guides/configure-sqlite-support.md b/13/umbraco-commerce/how-to-guides/configure-sqlite-support.md
@@ -34,9 +34,9 @@ After configuring Umbraco CMS with SQLite, Umbraco Commerce will automatically u
 {
     ...
     "ConnectionStrings": {
-        "umbracoDbDSN": "Data Source=|DataDirectory|/Umbraco.sqlite.db;Cache=Private;Foreign Keys=True;Pooling=True",
+        "umbracoDbDSN": "Data Source=|DataDirectory|/Umbraco.sqlite.db;Cache=Shared;Foreign Keys=True;Pooling=True",
         "umbracoDbDSN_ProviderName": "Microsoft.Data.SQLite",
-        "umbracoCommerceDbDSN": "Data Source=|DataDirectory|/Umbraco.Commerce.sqlite.db;Mode=ReadWrite;Foreign Keys=True;Pooling=True;Cache=Private",
+        "umbracoCommerceDbDSN": "Data Source=|DataDirectory|/Umbraco.Commerce.sqlite.db;Mode=ReadWrite;Foreign Keys=True;Pooling=True;Cache=Shared",
         "umbracoCommerceDbDSN_ProviderName": "Microsoft.Data.SQLite"
     },
     ...
diff --git a/15/umbraco-cms/fundamentals/setup/install/unattended-install.md b/15/umbraco-cms/fundamentals/setup/install/unattended-install.md
@@ -47,7 +47,7 @@ It is recommended that you make use of the values shown below for the `Cache`, `
 ```json
 {
   "ConnectionStrings": {
-    "umbracoDbDSN": "Data Source=|DataDirectory|/Umbraco.sqlite.db;Cache=Private;Foreign Keys=True;Pooling=True",
+    "umbracoDbDSN": "Data Source=|DataDirectory|/Umbraco.sqlite.db;Cache=Shared;Foreign Keys=True;Pooling=True",
     "umbracoDbDSN_ProviderName": "Microsoft.Data.Sqlite"
   }
 }
diff --git a/15/umbraco-cms/fundamentals/setup/upgrading/version-specific/README.md b/15/umbraco-cms/fundamentals/setup/upgrading/version-specific/README.md
@@ -262,9 +262,9 @@ The deprecated version, `Microsoft.Data.SQlite`, has been removed and will requi
 {
     ...
     "ConnectionStrings": {
-        "umbracoDbDSN": "Data Source=|DataDirectory|/Umbraco.sqlite.db;Cache=Private;Foreign Keys=True;Pooling=True",
+        "umbracoDbDSN": "Data Source=|DataDirectory|/Umbraco.sqlite.db;Cache=Shared;Foreign Keys=True;Pooling=True",
         "umbracoDbDSN_ProviderName": "Microsoft.Data.Sqlite",
-        "umbracoCommerceDbDSN": "Data Source=|DataDirectory|/Umbraco.Commerce.sqlite.db;Mode=ReadWrite;Foreign Keys=True;Pooling=True;Cache=Private",
+        "umbracoCommerceDbDSN": "Data Source=|DataDirectory|/Umbraco.Commerce.sqlite.db;Mode=ReadWrite;Foreign Keys=True;Pooling=True;Cache=Shared",
         "umbracoCommerceDbDSN_ProviderName": "Microsoft.Data.Sqlite"
     },
     ...
diff --git a/15/umbraco-cms/reference/configuration/connectionstringssettings.md b/15/umbraco-cms/reference/configuration/connectionstringssettings.md
@@ -11,14 +11,14 @@ The connection strings config can look like this:
 ```json
 {
   "ConnectionStrings": {
-    "umbracoDbDSN": "Data Source=|DataDirectory|/Umbraco.sqlite.db;Cache=Private;Foreign Keys=True;Pooling=True",
+    "umbracoDbDSN": "Data Source=|DataDirectory|/Umbraco.sqlite.db;Cache=Shared;Foreign Keys=True;Pooling=True",
     "umbracoDbDSN_ProviderName": "Microsoft.Data.Sqlite"
   }
 }
 ```
 
 {% hint style="info" %}
-We recommend using private cache for SQLite. You can read more on why shared cache is discouraged in [the official SQLite documentation](https://sqlite.org/sharedcache.html).
+We recommend using shared cache for SQLite when using Umbraco, as it provides better performance and consistency when multiple connections may access the database simultaneously.
 {% endhint %}
 
 The connection string used here is an SQLite connection string, that will connect to a data in the file `Umbraco.sqlite.db`  located in `/umbraco/Data` .
diff --git a/15/umbraco-commerce/how-to-guides/configure-sqlite-support.md b/15/umbraco-commerce/how-to-guides/configure-sqlite-support.md
@@ -34,9 +34,9 @@ After configuring Umbraco CMS with SQLite, Umbraco Commerce will automatically u
 {
     ...
     "ConnectionStrings": {
-        "umbracoDbDSN": "Data Source=|DataDirectory|/Umbraco.sqlite.db;Cache=Private;Foreign Keys=True;Pooling=True",
+        "umbracoDbDSN": "Data Source=|DataDirectory|/Umbraco.sqlite.db;Cache=Shared;Foreign Keys=True;Pooling=True",
         "umbracoDbDSN_ProviderName": "Microsoft.Data.Sqlite",
-        "umbracoCommerceDbDSN": "Data Source=|DataDirectory|/Umbraco.Commerce.sqlite.db;Mode=ReadWrite;Foreign Keys=True;Pooling=True;Cache=Private",
+        "umbracoCommerceDbDSN": "Data Source=|DataDirectory|/Umbraco.Commerce.sqlite.db;Mode=ReadWrite;Foreign Keys=True;Pooling=True;Cache=Shared",
         "umbracoCommerceDbDSN_ProviderName": "Microsoft.Data.Sqlite"
     },
     ...
diff --git a/16/umbraco-cms/fundamentals/setup/install/unattended-install.md b/16/umbraco-cms/fundamentals/setup/install/unattended-install.md
@@ -47,7 +47,7 @@ It is recommended that you make use of the values shown below for the `Cache`, `
 ```json
 {
   "ConnectionStrings": {
-    "umbracoDbDSN": "Data Source=|DataDirectory|/Umbraco.sqlite.db;Cache=Private;Foreign Keys=True;Pooling=True",
+    "umbracoDbDSN": "Data Source=|DataDirectory|/Umbraco.sqlite.db;Cache=Shared;Foreign Keys=True;Pooling=True",
     "umbracoDbDSN_ProviderName": "Microsoft.Data.Sqlite"
   }
 }
diff --git a/16/umbraco-cms/fundamentals/setup/upgrading/version-specific/README.md b/16/umbraco-cms/fundamentals/setup/upgrading/version-specific/README.md
@@ -301,9 +301,9 @@ The deprecated version, `Microsoft.Data.SQlite`, has been removed and will requi
 {
     ...
     "ConnectionStrings": {
-        "umbracoDbDSN": "Data Source=|DataDirectory|/Umbraco.sqlite.db;Cache=Private;Foreign Keys=True;Pooling=True",
+        "umbracoDbDSN": "Data Source=|DataDirectory|/Umbraco.sqlite.db;Cache=Shared;Foreign Keys=True;Pooling=True",
         "umbracoDbDSN_ProviderName": "Microsoft.Data.Sqlite",
-        "umbracoCommerceDbDSN": "Data Source=|DataDirectory|/Umbraco.Commerce.sqlite.db;Mode=ReadWrite;Foreign Keys=True;Pooling=True;Cache=Private",
+        "umbracoCommerceDbDSN": "Data Source=|DataDirectory|/Umbraco.Commerce.sqlite.db;Mode=ReadWrite;Foreign Keys=True;Pooling=True;Cache=Shared",
         "umbracoCommerceDbDSN_ProviderName": "Microsoft.Data.Sqlite"
     },
     ...
diff --git a/16/umbraco-cms/reference/configuration/connectionstringssettings.md b/16/umbraco-cms/reference/configuration/connectionstringssettings.md
@@ -11,14 +11,14 @@ The connection strings config can look like this:
 ```json
 {
   "ConnectionStrings": {
-    "umbracoDbDSN": "Data Source=|DataDirectory|/Umbraco.sqlite.db;Cache=Private;Foreign Keys=True;Pooling=True",
+    "umbracoDbDSN": "Data Source=|DataDirectory|/Umbraco.sqlite.db;Cache=Shared;Foreign Keys=True;Pooling=True",
     "umbracoDbDSN_ProviderName": "Microsoft.Data.Sqlite"
   }
 }
 ```
 
 {% hint style="info" %}
-We recommend using private cache for SQLite. You can read more on why shared cache is discouraged in [the official SQLite documentation](https://sqlite.org/sharedcache.html).
+We recommend using shared cache for SQLite when using Umbraco, as it provides better performance and consistency when multiple connections may access the database simultaneously.
 {% endhint %}
 
 The connection string used here is an SQLite connection string, that will connect to a data in the file `Umbraco.sqlite.db`  located in `/umbraco/Data` .
diff --git a/16/umbraco-commerce/how-to-guides/configure-sqlite-support.md b/16/umbraco-commerce/how-to-guides/configure-sqlite-support.md
@@ -34,9 +34,9 @@ After configuring Umbraco CMS with SQLite, Umbraco Commerce will automatically u
 {
     ...
     "ConnectionStrings": {
-        "umbracoDbDSN": "Data Source=|DataDirectory|/Umbraco.sqlite.db;Cache=Private;Foreign Keys=True;Pooling=True",
+        "umbracoDbDSN": "Data Source=|DataDirectory|/Umbraco.sqlite.db;Cache=Shared;Foreign Keys=True;Pooling=True",
         "umbracoDbDSN_ProviderName": "Microsoft.Data.Sqlite",
-        "umbracoCommerceDbDSN": "Data Source=|DataDirectory|/Umbraco.Commerce.sqlite.db;Mode=ReadWrite;Foreign Keys=True;Pooling=True;Cache=Private",
+        "umbracoCommerceDbDSN": "Data Source=|DataDirectory|/Umbraco.Commerce.sqlite.db;Mode=ReadWrite;Foreign Keys=True;Pooling=True;Cache=Shared",
         "umbracoCommerceDbDSN_ProviderName": "Microsoft.Data.Sqlite"
     },
     ...

Original file line number	Diff line number	Diff line change
@@ -47,7 +47,7 @@ It is recommended that you make use of the values shown below for the `Cache`, `
`47`	`47`	```json
`48`	`48`	`{`
`49`	`49`	`"ConnectionStrings": {`
`50`		`- "umbracoDbDSN": "Data Source=\|DataDirectory\|/Umbraco.sqlite.db;Cache=Private;Foreign Keys=True;Pooling=True",`
	`50`	`+ "umbracoDbDSN": "Data Source=\|DataDirectory\|/Umbraco.sqlite.db;Cache=Shared;Foreign Keys=True;Pooling=True",`
`51`	`51`	`"umbracoDbDSN_ProviderName": "Microsoft.Data.SQLite"`
`52`	`52`	`}`
`53`	`53`	`}`
Original file line number	Diff line number	Diff line change
`@@ -12,14 +12,14 @@ An connection strings config can look like this:`
`12`	`12`	```json
`13`	`13`	`{`
`14`	`14`	`"ConnectionStrings": {`
`15`		`- "umbracoDbDSN": "Data Source=\|DataDirectory\|/Umbraco.sqlite.db;Cache=Private;Foreign Keys=True;Pooling=True",`
	`15`	`+ "umbracoDbDSN": "Data Source=\|DataDirectory\|/Umbraco.sqlite.db;Cache=Shared;Foreign Keys=True;Pooling=True",`
`16`	`16`	`"umbracoDbDSN_ProviderName": "Microsoft.Data.SQLite"`
`17`	`17`	`}`
`18`	`18`	`}`
`19`	`19`	```
`20`	`20`
`21`	`21`	`{% hint style="info" %}`
`22`		`-We recommend using private cache for SQLite. You can read more on why shared cache is discouraged in [the official SQLite documentation](https://sqlite.org/sharedcache.html).`
	`22`	`+We recommend using shared cache for SQLite when using Umbraco, as it provides better performance and consistency when multiple connections may access the database simultaneously.`
`23`	`23`	`{% endhint %}`
`24`	`24`
`25`	`25`	The connection string used here is an SQLite connection string, that will connect to a data in the file `Umbraco.sqlite.db` located in `/umbraco/Data` .
Original file line number	Diff line number	Diff line change
`@@ -11,14 +11,14 @@ An connection strings config can look like this:`
`11`	`11`	```json
`12`	`12`	`{`
`13`	`13`	`"ConnectionStrings": {`
`14`		`- "umbracoDbDSN": "Data Source=\|DataDirectory\|/Umbraco.sqlite.db;Cache=Private;Foreign Keys=True;Pooling=True",`
	`14`	`+ "umbracoDbDSN": "Data Source=\|DataDirectory\|/Umbraco.sqlite.db;Cache=Shared;Foreign Keys=True;Pooling=True",`
`15`	`15`	`"umbracoDbDSN_ProviderName": "Microsoft.Data.SQLite"`
`16`	`16`	`}`
`17`	`17`	`}`
`18`	`18`	```
`19`	`19`
`20`	`20`	`{% hint style="info" %}`
`21`		`-We recommend using private cache for SQLite. You can read more on why shared cache is discouraged in [the official SQLite documentation](https://sqlite.org/sharedcache.html).`
	`21`	`+We recommend using shared cache for SQLite when using Umbraco, as it provides better performance and consistency when multiple connections may access the database simultaneously.`
`22`	`22`	`{% endhint %}`
`23`	`23`
`24`	`24`	The connection string used here is an SQLite connection string, that will connect to a data in the file `Umbraco.sqlite.db` located in `/umbraco/Data` .
Original file line number	Diff line number	Diff line change
`@@ -11,14 +11,14 @@ The connection strings config can look like this:`
`11`	`11`	```json
`12`	`12`	`{`
`13`	`13`	`"ConnectionStrings": {`
`14`		`- "umbracoDbDSN": "Data Source=\|DataDirectory\|/Umbraco.sqlite.db;Cache=Private;Foreign Keys=True;Pooling=True",`
	`14`	`+ "umbracoDbDSN": "Data Source=\|DataDirectory\|/Umbraco.sqlite.db;Cache=Shared;Foreign Keys=True;Pooling=True",`
`15`	`15`	`"umbracoDbDSN_ProviderName": "Microsoft.Data.Sqlite"`
`16`	`16`	`}`
`17`	`17`	`}`
`18`	`18`	```
`19`	`19`
`20`	`20`	`{% hint style="info" %}`
`21`		`-We recommend using private cache for SQLite. You can read more on why shared cache is discouraged in [the official SQLite documentation](https://sqlite.org/sharedcache.html).`
	`21`	`+We recommend using shared cache for SQLite when using Umbraco, as it provides better performance and consistency when multiple connections may access the database simultaneously.`
`22`	`22`	`{% endhint %}`
`23`	`23`
`24`	`24`	The connection string used here is an SQLite connection string, that will connect to a data in the file `Umbraco.sqlite.db` located in `/umbraco/Data` .