Nextcloud-Linux-``0344`` (#533)

* Nextcloud linux integration

* Server path fix

* Nextcloud-Linux-```0344```
This commit is contained in:
H0mer
2023-10-26 17:28:54 +02:00
committed by GitHub
parent 6439dcec09
commit dedaab1bd5
15 changed files with 98 additions and 17 deletions

Binary file not shown.

After

Width:  |  Height:  |  Size: 66 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 56 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 53 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 58 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 57 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 22 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 22 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 28 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 35 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 21 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 36 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 20 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 19 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 580 KiB

After

Width:  |  Height:  |  Size: 98 KiB

View File

@@ -16,7 +16,7 @@ Desktop Integrations
--------------------
Many Linux distributions ship with a Desktop Environment (DE) that supports Nextcloud account integration directly for use with their built-in calendars and other applications. It is recommended to try these first for the best possible experience with your particular flavor of Linux.
You will first need to :ref:`add your Root CA to your system<lan-linux>`.
You will first need to :ref:`trust your Root CA<ca-linux>`.
The following desktop environments support integrated account syncing, including Nextcloud:
@@ -25,11 +25,45 @@ The following desktop environments support integrated account syncing, including
- KDE
- Budgie
Check out this `Linuxhint guide <https://linuxhint.com/linux_file_managers_nextcloud/>`_ and our `Nextcloud Master Thread <https://community.start9.com/t/nextcloud-master-thread/>`_ for assistance. Please share your feedback - it is very valuable to our community!
The following guide uses Ubuntu as an example.
1. Open settings app.
.. figure:: /_static/images/nextcloud/nextcloud-linux-1.png
:width: 60%
:alt: open settings app
2. Go to Online Accounts and click on **Nextcloud**.
.. figure:: /_static/images/nextcloud/nextcloud-linux-2.png
:width: 60%
:alt: online accounts settings
3. Paste in the server path from **StartOS > Nextcloud > Interfaces** and the username and password from **StartOS > Nextcloud > Properties**, and click **Connect**.
.. figure:: /_static/images/nextcloud/nextcloud-linux-3.png
:width: 60%
:alt: enter nextcloud credentials
4. Choose which services you want to integrate and close **Nextcloud Account** window.
.. figure:: /_static/images/nextcloud/nextcloud-linux-4.png
:width: 60%
:alt: nextcloud account services
5. Open the file manager, and you should see your NextCloud account in the side panel.
.. figure:: /_static/images/nextcloud/nextcloud-linux-5.png
:width: 60%
:alt: nextcloud in file manager
To setup other Linux distributions, check out this `Linuxhint guide <https://linuxhint.com/linux_file_managers_nextcloud/>`_ and our `Nextcloud Master Thread <https://community.start9.com/t/nextcloud-master-thread/>`_. Please share your feedback - it is very valuable to our community!
Standalone Clients
------------------
For if your desktop environment does not support account integrations, or if you just prefer to use a desktop client.
For those that prefer to use a desktop client or your desktop environment does not support account integrations.
.. note:: The desktop version of NextCloud doesn't have much of a user interface. Once installed, it solely lives in the your system tray or navigation bar. You can click on this icon to access the app.
File Syncing - Nextcloud Desktop
================================
@@ -37,24 +71,71 @@ This is Nextcloud's official client application for file syncing and account man
LAN Setup
.........
Make sure you have first set up :ref:`LAN access<lan-linux>`.
Make sure you have first set up :ref:`trusted your Root CA<ca-linux>`.
1. Open the client and click "Log In"
2. From your server's Nextcloud Service page, go to "Interfaces" and copy the LAN address
3. Enter your LAN address under "Server Address" and click "Next"
4. You will be asked to Trust your server's certificate, which is safe to do as you generate and sign this during LAN Setup
5. Tick the box for "Trust this certificate anyway" and click "Next"
6. This will launch a page in your web browser, click "Log In" and then "Grant access" to link the desktop client. You can close this browser window afterwards
7. Next, configure the local directory that you want to sync with Nextcloud. You may use the default or change it, and edit the sync settings to desired. When satisfied, click "Connect"
8. Files will begin to sync immediately and you will see a green check when this is complete.
9. That's it! From this desktop client you will recieve notifications, control accounts and syncing, and quickly access your Apps' WebUI pages
1. Open the client and click **Log In to your Nextcloud**.
.. figure:: /_static/images/nextcloud/nextcloud-linux-desktop-1.png
:width: 60%
:alt: nextcloud login
2. From your server's Nextcloud Service page, go to **Interfaces** and copy the LAN address.
.. figure:: /_static/images/nextcloud/nextcloud-mac-step3-lan.png
:width: 60%
:alt: nextcloud interfaces
3. Enter your LAN address under **Server Address** and click **Next**.
.. figure:: /_static/images/nextcloud/nextcloud-linux-desktop-2.png
:width: 60%
:alt: nextcloud server path
4. This will launch a page in your web browser, click **Log In** and then **Grant access** to link the desktop client. You can close this browser window afterwards.
.. figure:: /_static/images/nextcloud/nextcloud-mac-step5.png
:width: 60%
:alt: nextcloud login and grant access
5. Next, configure the local directory that you want to sync with Nextcloud. You may use the default or change it, and edit the sync settings to desired. When satisfied, click **Connect**.
.. figure:: /_static/images/nextcloud/nextcloud-linux-desktop-3.png
:width: 60%
:alt: nextcloud add account
6. Files will begin to sync immediately and you will see a green check when this is complete.
.. figure:: /_static/images/nextcloud/nextcloud-linux-desktop-5.png
:width: 60%
:alt: nextcloud sync
7. That's it! From this desktop client you will recieve notifications, control accounts and syncing, and quickly access your Apps' WebUI pages
Tor Setup
.........
You will first need to have the :ref:`Tor daemon running<tor-linux>`.
1. On your desktop application. Click the account in the top left -> Settings, then in Settings, click Network, then "Specify proxy manually as" and "SOCKS5 proxy." Enter "127.0.0.1" for the Host and "9050" for the port.
2. Close the Settings screen and click the account in the top left again, then "Add Account."
3. On the following screen, click "Log in," then enter your Nextcloud Tor server address, which you can copy from the Nextcloud page on your Embassy -> Interfaces -> Tor. This must start with `http://` and end with `.onion`. Click Next.
1. On your desktop application. Click the account avatar in the top left > Settings, then click Network. Choose **Specify proxy manually as** and **SOCKS5 proxy**. Enter **127.0.0.1** for the Host and **9050** for the port.
.. figure:: /_static/images/nextcloud/nextcloud-linux-tor-1.png
:width: 60%
:alt: nextcloud network settings
2. Close the Settings screen and click the account in the top left again, then **Add Account**.
.. figure:: /_static/images/nextcloud/nextcloud-linux-tor-2.png
:width: 60%
:alt: nextcloud add account
3. On the following screen, click **Log in your Nextcloud**, then enter your Nextcloud Tor server address, which you can copy from the Nextcloud page on your **StartOS > Interfaces > Tor**.
.. figure:: /_static/images/nextcloud/nextcloud-linux-desktop-1.png
:width: 60%
:alt: nextcloud server path
.. figure:: /_static/images/nextcloud/nextcloud-linux-tor-3.png
:width: 60%
:alt: nextcloud add account
4. This will launch your browser and prompt you to log in to your account. Log in and then grant access as we did for LAN.
5. That's it! You may wish to set up some select folders for remote sync, but for large files, it is best to sync on LAN only, so you can "Skip folders configuration" on the resulting screen if you wish. Check your connection by clicking the newly created account in the client app.
5. That's it! You can set up some select folders for remote sync, but for large files, it is best to sync on LAN only. Check your connection by clicking the newly created account in the client app.