Better document how to use custom app directories and how to move apps between directories #3643
Conversation
| "writable" => true, | ||
| ), | ||
| ), | ||
| If you want to store apps in a custom directory, instead of ownCloud’s default (``/app``), you need to modify the ``apps_paths`` element in ``config/config.php``. |
There was a problem hiding this comment.
I would add the reason why such an approach is a good idea, text as an example.
- You separate core apps from user/admin downloaded apps to ease distinguishing
- Core apps are downloaded by core preferrable to the apps folder
- Core may add new core related apps which are managed or downloaded during the installation process. Apps not used by core anymore may stay then as orphans in the apps folder when you upgrade
- When you upgrade the instance and extract the new code into an empty folder, copying/aliasing the data folder, the config.php file ect (for details see upgrading...) you will also need to copy all manually downloaded apps. Having those in an separate directory eases the process of doing so because you then just need to take care on that folder.
There was a problem hiding this comment.
@mmattel, what do you mean by: "Core apps are downloaded by core preferrable to the apps folder"?
| These are: | ||
|
|
||
| - ``path``: The absolute file system path to the custom app folder. | ||
| - ``url``: The request path to that folder relative to the ownCloud web root. |
There was a problem hiding this comment.
Text add:
Please use a mandatory / on front of the url
| To do so, follow these steps: | ||
|
|
||
| #. Enable maintenance mode | ||
| #. Disable the apps that you want to move |
There was a problem hiding this comment.
#. Create a new directory and assign the same rights and owncership as the apps folder to it
Move the apps from the old to a new --> the new apps directory
de000c3 to
72a64d3
Compare
|
@mmattel, updates have been made to include your feedback. Can you review pls? |
| #. Move the apps from the old apps directory to the new apps directory. | ||
| #. Add a new app directory in ``config/config.php``. | ||
| #. Re-enable the apps. | ||
| #. Disable maintenance mode. | ||
|
|
||
| Manually Installing Apps | ||
| ------------------------ | ||
|
|
||
| To install an app manually (locally), instead of by using the Appstore, copy the app into the ownCloud app folder (``/path/to/owncloud/apps``). |
There was a problem hiding this comment.
Missed that one before 😃
...into the ownCloud app or custom app folder...
or appropriate app folder, something like that
There was a problem hiding this comment.
It seems fine to me as is, honestly.
| The folder name of the app and the name of the app **must be identical**. |
There was a problem hiding this comment.
Where do you get the proper app name so you can create the right folder?
Please mention rights/permissions ect things...
There was a problem hiding this comment.
Updated in 29163fc.
|
Just added 2 improvement requests, then it is fine to me 👍 |
This commit replaces the Appstore reference with a link to the Marketplace, links to relevant sections of the documentation, and provides an XML snippet of an appinfo/info.xml file, to help the docs be more meaningful. Signed-off-by: Matthew Setter <matthew@matthewsetter.com>
|
Thanks! |
|
@settermjd Many thanks for writing this! |
|
More than happy to. Thanks for all your help. |
This PR, as the description says, updates the custom app directories documentation. It's on hold, owing to a bug identified in owncloud/core#29917 and owncloud/core#29807.
References
#3261.