Skip to content

Commit 6b8c769

Browse files
docs(README): clarify apps_paths migration instructions
Combine steps 3.2 and 3.3 under "Migrating an existing installation" into a single "replace" instruction. The previous two-step approach ("delete your apps_paths" then "add this apps_paths") was ambiguous and could be misread as requiring no apps_paths configuration at all after step 3.2. The revised step explains that any existing apps_paths configuration should be replaced with the Docker-compatible version, notes that the existing configuration may vary in form, and briefly explains why the apps directory must be non-writable and custom_apps writable. Signed-off-by: Josh <josh.t.richards@gmail.com>
1 parent 8405a5b commit 6b8c769

1 file changed

Lines changed: 3 additions & 12 deletions

File tree

README.md

Lines changed: 3 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -738,6 +738,7 @@ You're already using Nextcloud and want to switch to docker? Great! Here are som
738738
docker compose exec db sh -c "psql -U USER --set ON_ERROR_STOP=on nextcloud < /dmp"
739739
docker compose exec db rm /dmp
740740
```
741+
3. Edit your config.php
741742
3. Edit your config.php
742743
1. Set database connection
743744
- In case of MySQL database
@@ -748,17 +749,7 @@ You're already using Nextcloud and want to switch to docker? Great! Here are som
748749
```php
749750
'dbhost' => 'db:5432',
750751
```
751-
2. Make sure you have no configuration for the `apps_paths`. Delete lines like these
752-
```php
753-
'apps_paths' => array (
754-
0 => array (
755-
'path' => OC::$SERVERROOT.'/apps',
756-
'url' => '/apps',
757-
'writable' => true,
758-
),
759-
),
760-
```
761-
3. Make sure to have the `apps` directory non writable and the `custom_apps` directory writable
752+
2. Replace any existing `apps_paths` configuration with the following Docker-compatible version. Your existing configuration may look different (e.g. using `OC::$SERVERROOT.'/apps'` or having only a single entry), but it must be replaced with exactly this to ensure shipped apps in `apps` are non-writable and user-installed apps go to `custom_apps`:
762753
```php
763754
'apps_paths' => array (
764755
0 => array (
@@ -773,7 +764,7 @@ You're already using Nextcloud and want to switch to docker? Great! Here are som
773764
),
774765
),
775766
```
776-
4. Make sure your data directory is set to /var/www/html/data
767+
3. Make sure your data directory is set to /var/www/html/data
777768
```php
778769
'datadirectory' => '/var/www/html/data',
779770
```

0 commit comments

Comments
 (0)