commit 54b7fb7

Merge: 7387234 71f88cc
Author: Lukas Hirt <lhirt@owncloud.com>
Date:   Tue Dec 8 16:54:40 2020 +0100

    Merge pull request #4427 from owncloud/oc10-app

deployments/_index.md

@@ -0,0 +1,10 @@
+---
+title: "Deployments"
+date: 2018-05-02T00:00:00+00:00
+weight: 55
+geekdocRepo: https://github.com/owncloud/phoenix
+geekdocEditPath: edit/master/docs/deployments
+geekdocFilePath: _index.md
+---
+
+Showcases of different scenarios of deploying ownCloud Web.

deployments/oc10-app.md

@@ -0,0 +1,68 @@
+---
+title: "Deploy as an app in ownCloud 10"
+date: 2018-05-02T00:00:00+00:00
+weight: 1
+geekdocRepo: https://github.com/owncloud/phoenix
+geekdocEditPath: edit/master/docs/deployments
+geekdocFilePath: oc10-app.md
+---
+
+{{< toc >}}
+
+One of the build artifacts of the ownCloud Web is a ownCloud 10 app bundle.
+
+## Prerequisites
+- Running [ownCloud 10 server](https://owncloud.com/download-server/) with version 10.6
+- Installed [oauth2 app](https://marketplace.owncloud.com/apps/oauth2)
+
+## Deploying ownCloud Web
+To download the ownCloud Web, go to https://github.com/owncloud/phoenix/releases and pick your desired version. In the release, you will find a file called `phoenix-app.tar.gz`.
+Download this file and move it into the `apps` folder in your ownCloud 10 server.
+
+{{< hint info >}}
+The app bundle is provided only from version 1.0.0
+{{< /hint >}}
+
+To unpack the app, run the following command: 
+```bash
+tar -xzf phoenix.tar.gz && rm -Rf phoenix-app.tar.gz
+```
+
+Next step is to enable the app:
+```bash
+cd ../ && occ apps:enable phoenix
+```
+
+## Configure oauth2
+In the `Admin` of ownCloud 10, head into `User Authentication` and add a new client with arbitrary name and redirection URL `https://<your-owncloud-server>/apps/phoenix/oidc-callback.html`.
+
+## Configure ownCloud 10
+To display ownCloud Web in the app switcher and to redirect all private and public links to the new WebUI, add the following config into `config/config.php`:
+
+```php
+'phoenix.baseUrl' => 'https://<your-owncloud-server>/apps/phoenix',
+```
+
+## Configure ownCloud Web
+There are a few config values which need to be set in order for ownCloud Web to work correctly. Navigate into `apps/phoenix` and adjust `config.json` according to the following example:
+
+```json
+{
+ "server" : "https://<your-owncloud-server>", // ownCloud 10 server address
+ "theme": "owncloud", // Theme to be used in ownCloud Web pointing to a json file inside of `themes` folder
+ "auth": {
+ "clientId": "<client-id-from-oauth2>", // Client ID received when adding ownCloud Web in the `User Authentication` section in `Admin`
+ "url": "https://<your-owncloud-server>/index.php/apps/oauth2/api/v1/token",
+ "authUrl": "https://<your-owncloud-server>/index.php/apps/oauth2/authorize"
+ },
+ "apps" : [ // List of extensions to be loaded
+ "files"
+ ],
+ "applications" : [] // Apps to be displayed in the application switcher
+}
+```
+
+## Accessing ownCloud Web
+After following all the steps, you should see a new entry in the application switcher called `New Design` which points to the ownCloud web.
+
+{{< figure src="/phoenix/static/application-switcher-oc10.jpg" >}}