Start9/documentation
2
0
Fork 0
mirror of https://github.com/Start9Labs/documentation.git synced 2026-03-30 04:01:59 +00:00
Code Issues Packages Projects Releases Wiki Activity

restructure docs

Browse Source
This commit is contained in:
Matt Hill
2023-11-06 12:34:37 -07:00
parent 80651a6609
commit fe79d71e7c
150 changed files with 404 additions and 1866 deletions
Download Patch File Download Diff File Expand all files Collapse all files

13
site/source/service-guides/nextcloud/index.rst Normal file
View File

@@ -0,0 +1,13 @@
.. _nextcloud-service:
=========
Nextcloud
=========
These guides will help you to setup tools to connect or interact with Nextcloud.
.. toctree::
:maxdepth: 1
nextcloud-setup/index
nextcloud-apps/index

34
site/source/service-guides/nextcloud/nextcloud-apps/index.rst Normal file
View File

@@ -0,0 +1,34 @@
.. _nextcloud-apps:
=============================
Nextcloud Apps & Integrations
=============================
Nextcloud is highly extensible and even has its own `App Store <https://apps.nextcloud.com/>`_. The following guides will help you with the setup, connection, and use of Start9-curated Nextcloud Apps as well as third-party integrations for your server.
Apps
----
.. toctree::
:maxdepth: 1
nc-bookmarks
nc-calendar
nc-contacts
nc-cookbook
nc-files
nc-maps
nc-memories
nc-music
nc-news
nc-notes
nc-photos
Integrations
------------
.. toctree::
:maxdepth: 1
joplin
thunderbird

105
site/source/service-guides/nextcloud/nextcloud-apps/joplin.rst Normal file
View File

@@ -0,0 +1,105 @@
.. _nc-joplin:
==================
Joplin Integration
==================
`Joplin <https://joplinapp.org/>`_ is an open source note-taking app. Capture your thoughts and securely access them from any device. First set up your :ref:`client devices<nextcloud-setup>`, so that Nextcloud will automatically keep your notes synced.
Clients available for:
- Desktop
- Linux
- Mac
- Windows
- Mobile
- Android
- iOS
Connecting Joplin to Nextcloud (Mac Desktop Example)
----------------------------------------------------
This guide will go over how to connect Joplin running on a desktop machine to your Start9 server's Nextcloud over LAN.
.. note:: This guide assumes your Nextcloud username is "embassy," replace with your username if different.
You will need your device set up to connect via :ref:`LAN<connecting-lan>` first.
#. First go into Nextcloud on your server and click on the "Files" app icon.
.. figure:: /_static/images/nextcloud/joplin/joplin-setup0.png
:width: 30%
:alt: Click on Folders
#. Click on the + icon, then "New folder".
.. figure:: /_static/images/nextcloud/joplin/joplin-setup1.png
:width: 30%
:alt: New Folder
#. Create a new folder called "joplin" and click the arrow to the right.
.. figure:: /_static/images/nextcloud/joplin/joplin-setup3.png
:width: 30%
:alt: Joplin Directory
#. Click on "Files settings" in the bottom left and copy the WebDAV link.
.. figure:: /_static/images/nextcloud/joplin/joplin-setup4.png
:width: 30%
:alt: Files Settings
.. figure:: /_static/images/nextcloud/joplin/joplin-setup5.png
:width: 30%
:alt: WedDAV Link
#. Open up Joplin, click on "Joplin" in the top left and click "Preferences" (on Mac).
.. figure:: /_static/images/nextcloud/joplin/joplin-setup7.png
:width: 30%
:alt: Preferences
#. Click on "Synchronisation".
.. figure:: /_static/images/nextcloud/joplin/joplin-setup8.png
:width: 30%
:alt: Click on Synchronisation
#. Under "Synchronisation target" select "Nextcloud", paste the WebDAV and append onto the end of it "joplin" so the entire URL should look like this (replace ``xxxx`` with your unique Nextcloud LAN address): ``https://xxxx.local/remote.php/dav/files/embassy/joplin``.
.. figure:: /_static/images/nextcloud/joplin/joplin-setup9.png
:width: 30%
:alt: Click on Synchronization
#. Under "Nextcloud username" enter "embassy" (or your username).
#. Under "Nextcloud password" enter your password.
#. The username and password for your Nextcloud can be found in your server's UI by clicking on the Nextcloud service then clicking on "Properties".
.. figure:: /_static/images/nextcloud/joplin/joplin-setup10.png
:width: 30%
:alt: Select Nextcloud and enter URL
.. figure:: /_static/images/nextcloud/joplin/joplin-setup11.png
:width: 30%
:alt: Select Nextcloud and enter URL
#. Now click "Show advanced settings".
.. figure:: /_static/images/nextcloud/joplin/joplin-setup12.png
:width: 30%
:alt: Select Nextcloud and enter URL
#. Scroll down then check the box that says "Ignore TLS certificate errors".
.. figure:: /_static/images/nextcloud/joplin/joplin-setup13.png
:width: 30%
:alt: Select Nextcloud and enter URL
#. Now scroll back up and select "Check sychronisation configuration" and you should see the following success message:
.. figure:: /_static/images/nextcloud/joplin/joplin-setup14.png
:width: 30%
:alt: Select Nextcloud and enter URL
#. You have now connected your Joplin client to your Start9 server's Nextcloud and your notes will sync automatically!

46
site/source/service-guides/nextcloud/nextcloud-apps/nc-bookmarks.rst Normal file
View File

@@ -0,0 +1,46 @@
.. _nc-bookmarks:
===================
Nextcloud Bookmarks
===================
`Nextcloud Bookmarks <https://apps.nextcloud.com/apps/bookmarks>`_ is software for sorting, tagging, searching, sharing, and (most importantly) syncing your browser's bookmarks via your server. First set up your :ref:`client devices<nextcloud-setup>`, so that Nextcloud will automatically keep your bookmarks synced.
Clients available for:
- Mobile
- Android
- Desktop Browsers
- Chrome
- Edge
- Firefox
NC App Setup
------------
#. Begin by downloading Bookmarks from your Nextcloud service's App Store (Top-right menu -> Apps).
.. tip:: Use the "Search" function to quickly find the App you are looking for
#. Once installed/enabled, you will get a new icon in your top menu for "Bookmarks." Click it to get started.
- At this point you can begin adding bookmarks directly into the app, or import them from a browser. These are always available by accessing your Nextcloud from your client devices.
- The real power here is in the ability to import or sync across devices. There are several clients that can accomplish this, which can be found on the `NC Bookmarks Github Page <https://github.com/nextcloud/bookmarks#third-party-clients>`_. For our example, and the recommended option if you click "Sync with your browser" from the Bookmarks welcome page, is `Floccus <https://floccus.org/>`_.
#. (Optional) In the "Settings" menu in the bottom-left, you may change the Nextcloud location in which to store your bookmarks. If you change this or create a new folder, be sure to reflect this change in Floccus below.
Browser & Mobile Setups
-----------------------
Floccus (Browser & Android)
...........................
#. Download the appropriate Floccus extension for your browser or app from the App Store, F-Droid, or Play Store.
#. Open the Floccus browser extension and click "+NEW ACCOUNT", select "Nextcloud Bookmarks", and then add your server address and login via Nextcloud.
#. (Optional) Edit the folder paths if changed above and select a local folder to save bookmarks to.
#. On the final setup page, use the defaults unless you are absolutely sure what you are doing. Click "Continue" and you're ready to sync!
.. note:: Repeat this process for any additional devices or browsers that you'd like to keep in sync.

31
site/source/service-guides/nextcloud/nextcloud-apps/nc-calendar.rst Normal file
View File

@@ -0,0 +1,31 @@
.. _nc-calendar:
==================
Nextcloud Calendar
==================
`Nextcloud Calendar <https://apps.nextcloud.com/apps/calendar>`_ is software for managing and syncing calendars, events, and tasks between your devices. First set up your :ref:`client devices<nextcloud-setup>`, so that Nextcloud will automatically keep your calendars synced.
Integrations available for:
- Mobile
- Android
- iOS
- Desktop
- Linux
- Mac
- Windows
NC App Setup
------------
#. On the latest Start9 Nextcloud service, Calendar is included by default. If coming from an older install, begin by downloading Calendar from your Nextcloud service's App Store (Top-right menu -> Apps).
.. tip:: Use the "Search" function to quickly find the App you are looking for
#. Once installed/enabled, you will get a new icon in your top menu for "Calendar." Click it to get started.
- At this point you can begin using the Calendar right away in the web UI. All changes will be reflected in any currently synced client devices, or on any added in future.
Client Integrations
-------------------
Client integrations can all be found in the :ref:`initial setup guides<nextcloud-setup>` for your device.

31
site/source/service-guides/nextcloud/nextcloud-apps/nc-contacts.rst Normal file
View File

@@ -0,0 +1,31 @@
.. _nc-contacts:
==================
Nextcloud Contacts
==================
`Nextcloud Contacts <https://apps.nextcloud.com/apps/contacts>`_ is software for managing and syncing your contacts between your devices. First set up your :ref:`client devices<nextcloud-setup>`, so that Nextcloud will automatically keep your contacts synced.
Integrations available for:
- Mobile
- Android
- iOS
- Desktop
- Linux
- Mac
- Windows
NC App Setup
------------
#. On the latest Start9 Nextcloud service, Contacts is included by default. If coming from an older install, begin by downloading Contacts from your Nextcloud service's App Store (Top-right menu -> Apps).
.. tip:: Use the "Search" function to quickly find the App you are looking for
#. Once installed/enabled, you will get a new icon in your top menu for "Contacts." There is also a quick access icon in the top-right. Click either to get started.
- At this point you can begin using your Contacts app right away in the WebUI. All changes will be reflected in any currently synced client devices, or on any added in future.
Client Integrations
-------------------
Client integrations can all be found in the :ref:`initial setup guides<nextcloud-setup>` for your device.

45
site/source/service-guides/nextcloud/nextcloud-apps/nc-cookbook.rst Normal file
View File

@@ -0,0 +1,45 @@
.. _nc-cookbook:
==================
Nextcloud Cookbook
==================
`Nextcloud Cookbook <https://apps.nextcloud.com/apps/cookbook>`_ is software for viewing, syncing, and organizing recipes. First set up your :ref:`client devices<nextcloud-setup>`, so that Nextcloud will automatically keep your recipes synced.
Clients available for:
- Mobile
- Android
- iOS
NC App Setup
------------
#. Begin by downloading Cookbook from your Nextcloud service's App Store (Top-right menu -> Apps).
.. tip:: Use the "Search" function to quickly find the App you are looking for
#. Once installed/enabled, you will get a new icon in your top menu for "Cookbook." Click it to get started.
#. You can now start adding recipes. Simply find a recipe online and copy the URL into the box on the left. In most cases, this will be translated into an easy-to-read recipe with ingredients and steps, and without all the distractions and junk included with most recipe pages.
.. tip:: Tag and categorize your recipes! Basic settings are available in the bottom-left menu.
Mobile Setups
-------------
Nextcloud Cookbook (Android / iOS)
..................................
There are 2 versions of this app available on Android, and one on iOS. Check this `repository <https://github.com/nextcloud/cookbook/>`_ for details.
#. Go to your app store of choice and install the Nextcloud Cookbook app.
#. (Android connection) You can select a previously connected Nextcloud account, or scan an app-specific QR, created under Nextcloud's main menu -> Personal Settings -> Security
#. (iOS connection) You will be prompted to enter the following:
- Server URL - get this from your server's Services -> Nextcloud -> Interfaces (LAN is recommended)
- Username - get this from your server's Services -> Nextcloud -> Properties (admin is default)
- Password - get this from your server's Services -> Nextcloud -> Properties
.. note:: You may need to enable "self-signed certificates" for LAN. This is safe to do as you are the signer of the cert and owner of all involved hardware.
#. As soon as you connect and sync, you will see your Cookbook!

29
site/source/service-guides/nextcloud/nextcloud-apps/nc-files.rst Normal file
View File

@@ -0,0 +1,29 @@
.. _nc-files:
===============
Nextcloud Files
===============
Nextcloud Files is software for managing and syncing your data between your devices. In practice it functions similarly to the file explorer on your computer. Files also serves as the base storage on your server for all the other apps that may need to access your data, such as documents, multimedia, and syncing apps. This even includes data storage for other Start9 services on your server, such as Jellyfin and Start9 Pages.
Integrations available for:
- Mobile
- Android
- iOS
- Desktop
- Linux
- Mac
- Windows
NC App Setup
------------
#. You will find an icon in your top menu for "Files." Click here to get started.
- You can begin using your Files app right away in the web UI. All changes will be reflected in any currently synced client devices, or on any added in future.
.. warning:: Keep in mind that if you delete a file in one location, it may be deleted across all locations!! Start with some test folders/files in order to understand how the syncing system works with your devices.
Client Integrations
-------------------
Client integrations can all be found in the :ref:`initial setup guides<nextcloud-setup>` for your device.

22
site/source/service-guides/nextcloud/nextcloud-apps/nc-maps.rst Normal file
View File

@@ -0,0 +1,22 @@
.. _nc-maps:
==============
Nextcloud Maps
==============
`Nextcloud Maps <https://apps.nextcloud.com/apps/maps>`_ is software for viewing and managing your places. First set up your :ref:`client devices<nextcloud-setup>`, so that Nextcloud will automatically keep your maps synced.
No clients available at this time.
NC App Setup
------------
#. Begin by downloading Maps from your Nextcloud service's App Store (Top-right menu -> Apps).
.. tip:: Use the "Search" function to quickly find the App you are looking for
#. Once installed/enabled, you will get a new icon in your top menu for "Maps." Click it to get started.
#. You can now browse `OpenStreetMap <https://www.openstreetmap.org/>`_, get directions, create favorite locations, add photos, and share custom maps.
.. tip:: You can find the settings for Maps in the bottom-left
.. note:: This is basic software at this time, havnig just reached 1.0, but features are planned by the developers for linking mobile devices for finding a lost or stolen device as well as fitness tracking and other modern location services.

27
site/source/service-guides/nextcloud/nextcloud-apps/nc-memories.rst Normal file
View File

@@ -0,0 +1,27 @@
.. _nc-memories:
==================
Nextcloud Memories
==================
`Nextcloud Memories <https://apps.nextcloud.com/apps/memories>`_ is software for viewing, managing, and organizing your photos. First set up your :ref:`client devices<nextcloud-setup>`, so that Nextcloud will automatically keep your photos synced.
Clients available for:
- Mobile
- Android
NC App Setup
------------
#. Begin by downloading Memories from your Nextcloud service's App Store (Top-right menu -> Apps).
.. tip:: Use the "Search" function to quickly find the App you are looking for
#. Once installed/enabled, you will get a new icon in your top menu for "Memories." Click it to get started.
#. You will see an image that says "Click Here To Start" - click it and select your media directory.
.. tip:: You can find the settings for Memories under the top-right menu -> Administrative Settings -> Memories
Desktop & Mobile Setups
-----------------------
This is currently a webUI only application, but you can use the same clients as those supported by :ref:`Nextcloud Photos<nc-photos>`.

34
site/source/service-guides/nextcloud/nextcloud-apps/nc-music.rst Normal file
View File

@@ -0,0 +1,34 @@
.. _nc-music:
===============
Nextcloud Music
===============
`Nextcloud Music <https://apps.nextcloud.com/apps/music>`_ is software for organizing and playing your music as well as managing and streaming podcasts and internet radio. First set up your :ref:`client devices<nextcloud-setup>`, so that Nextcloud will automatically keep your music synced.
Clients available for:
- Mobile
- Android
- iOS
- Garmin Watch
- Desktop:
- Linux
- Mac
- Windows
NC App Setup
------------
#. Begin by downloading Music from your Nextcloud service's App Store (Top-right menu -> Apps).
.. tip:: Use the "Search" function to quickly find the App you are looking for
#. Once installed/enabled, you will get a new icon in your top menu for "Music." Click it to get started.
#. You can now play existing music from your Nextcloud Files, or add an internet radio station or podcast feed!
.. tip:: You can set the media directory path in the 'Settings' menu on the bottom-left
Desktop & Mobile Setups
-----------------------
Nextcloud Music can be used by clients that support Ampache or Subsonic. See all the options in the 'Settings' menu on the bottom-left, or see the `Ampache client list <https://github.com/owncloud/music/wiki/Ampache>`_ or the `Subsonic client list <https://github.com/owncloud/music/wiki/Subsonic>`_.

33
site/source/service-guides/nextcloud/nextcloud-apps/nc-news.rst Normal file
View File

@@ -0,0 +1,33 @@
.. _nc-news:
==============
Nextcloud News
==============
`Nextcloud News <https://apps.nextcloud.com/apps/news>`_ is software for managing and viewing RSS feeds. First set up your :ref:`client devices<nextcloud-setup>`, so that Nextcloud will automatically keep your feeds synced.
Clients available for:
- Mobile
- Android
- iOS
- SailfishOS
- Desktop:
- Linux
- Mac
- Windows
- Unix Terminal
NC App Setup
------------
#. Begin by downloading News from your Nextcloud service's App Store (Top-right menu -> Apps).
.. tip:: Use the "Search" function to quickly find the App you are looking for
#. Once installed/enabled, you will get a new icon in your top menu for "News." Click it to get started.
- You can now add your favorite RSS feeds from the left-hand panel.
Desktop & Mobile Setups
-----------------------
Nextcloud News can be synced with a wide range of clients across almost any platform you can imagine. See all the options on the `official client list <https://nextcloud.github.io/news/clients/>`_.

49
site/source/service-guides/nextcloud/nextcloud-apps/nc-notes.rst Normal file
View File

@@ -0,0 +1,49 @@
.. _nc-notes:
===============
Nextcloud Notes
===============
`Nextcloud Notes <https://apps.nextcloud.com/apps/notes>`_ is software for managing and syncing your notes across devices. First set up your :ref:`client devices<nextcloud-setup>`, so that Nextcloud will automatically keep your notes synced.
Clients available for:
- Mobile
- Android
- iOS
- Desktop:
- Unix Terminal
NC App Setup
------------
#. Begin by downloading Notes from your Nextcloud service's App Store (Top-right menu -> Apps).
.. tip:: Use the "Search" function to quickly find the App you are looking for
#. Once installed/enabled, you will get a new icon in your top menu for "Notes." Click it to get started.
- You can now use the web UI to record your notes.
.. tip:: Markdown is supported
Desktop & Mobile Setups
-----------------------
The real beauty of Notes is being able to sync to your mobile devices for use on the go.
Nextcloud Notes (Android)
.........................
#. Download the Nextcloud Notes app from your favorite app store (Aurora, F-Droid, or Play Store).
#. On the opening screen, select your existing Nextcloud account. If one does not exist, make sure to start with your :ref:`client setup<nextcloud-setup>` or you can hit "Add Account," then create an app passcode QR under Nextcloud's main top-right menu -> Personal Settings -> Hamburger (3 lines) Menu > Security > Devices & Sessions > "Create new app password" and scan it to grant access.
#. You existing notes will now sync, or you can create your first note to test!
Nextcloud Notes (iOS)
.....................
#. Download the Nextcloud Notes app from the App Store.
#. Enter your Nextcloud server URL from your server: Nextcloud -> Interfaces (LAN recommended).
#. You will be redirected and asked for your username and password, both can be found on your server: Nextcloud -> Properties. Then Grant Access.
#. You'll be returned to the setup screen, just tap "Done," your existing notes will now sync, or you can create your first note to test!

30
site/source/service-guides/nextcloud/nextcloud-apps/nc-photos.rst Normal file
View File

@@ -0,0 +1,30 @@
.. _nc-photos:
================
Nextcloud Photos
================
Nextcloud Photos is a basic gallery for viewing and managing your photos. First set up your :ref:`client devices<nextcloud-setup>`, so that Nextcloud will automatically keep your photos synced.
Clients available for:
- Mobile
- Android
NC App Setup
------------
#. Photos is included by default and there will be an icon in your top menu for "Photos." Click it and you will be in the web UI viewing your gallery.
Desktop & Mobile Setups
-----------------------
Les Pas (Android)
.................
`Les Pas <https://github.com/scubajeff/lespas>`_ is a great mobile gallery for viewing and organizing your photos, gifs, and videos.
#. First, install Les Pas from your favorite app store (Aurora, F-Droid, or Play Store), or from `the github repository <https://github.com/scubajeff/lespas/releases>`_.
#. At the welcome screen, you will be asked to either enter your server URL or scan a QR code. In your Nextcloud instance, click the top-right menu -> Personal Settings -> Hamburger (3 lines) Menu > Security > Devices & Sessions > "Create new app password." Hit "Show QR Code" and then scan it with Les Pas.
#. You'll be sent to your Nextcloud instance to log in and grant access to the app.
- That's it! You're ready to view your photos with no third party involved!

84
site/source/service-guides/nextcloud/nextcloud-apps/thunderbird.rst Normal file
View File

@@ -0,0 +1,84 @@
.. _nc-thunderbird:
===========
Thunderbird
===========
.. contents::
:depth: 2
:local:
Calendar & Contacts Syncing
===========================
You can set up your devices using their :ref:`integrations<nextcloud-setup>`, but if you wish to use a standalone client for your Calendar and Contacts syncing, we recommend Mozilla's `Thunderbird <https://www.thunderbird.net>`_.
1. Install the :ref:`Calendar<nc-calendar>` and :ref:`Contacts<nc-contacts>` apps in Nextcloud if they are not currently installed.
2. Add your :ref:`RootCA<trust-ca>` to your system and then configure :ref:`Thunderbird<thunderbird>`.
3. Select Calendar or Contacts from below to complete each unique setup:
.. tabs::
.. group-tab:: Calendar
1. In Thunderbird, click on the calendar icon, then "New Address Book" in the bottom-left.
.. figure:: /_static/images/nextcloud/thunderbird-calendar-step1.png
:width: 60%
:alt: thunderbird add calendar
2. Choose "On the network," then click "Next".
.. figure:: /_static/images/nextcloud/thunderbird-calendar-step2.png
:width: 40%
:alt: thunderbird add calendar checkbox
3. Fill in the Username and Location fields with the credentials from Nextcloud > Properties on your Start9 server. Click "Find calendars".
.. figure:: /_static/images/nextcloud/thunderbird-calendar-step3.png
:width: 40%
:alt: thunderbird add calendar checkbox
4. Create a unique app password - In your Nextcloud WebUI, visit the top-right-hand menu and select "Personal Settings" -> "Security." At the bottom, under "Devices & Sessions," create a new app password with a name of your choice, such as "CalDAV." Copy the resulting password and paste it into Thunderbird.
.. figure:: /_static/images/nextcloud/native-nextcloud-integration-macos-step3.1.png
:width: 60%
:alt: nextcloud app password
.. figure:: /_static/images/nextcloud/thunderbird-contact-step3.png
:width: 40%
:alt: thunderbird add password
5. Check which calendars you want to integrate and click "Subscribe".
.. figure:: /_static/images/nextcloud/thunderbird-calendar-step5.png
:width: 40%
:alt: thunderbird add calendar subscribe
Your Nextcloud calendar will now sync with Thunderbird. Click on the "Contacts" tab above to add your contacts.
.. group-tab:: Contacts
1. Click on the Address Book icon, open the drop-down menu for "New Address Book" and click "Add CarDav Address Book".
.. figure:: /_static/images/nextcloud/thunderbird-contact-step1.png
:width: 60%
:alt: thunderbird add new contact book
2. Fill in the Username and Location fields with the credentials from Nextcloud > Properties on your Start9 server. Click "Continue".
.. figure:: /_static/images/nextcloud/thunderbird-contact-step2.png
:width: 60%
:alt: thunderbird add new contact book
3. Create a unique app password - In your Nextcloud WebUI, visit the top-right-hand menu and select "Personal Settings" -> "Security." At the bottom, under "Devices & Sessions," create a new app password with a name of your choice, such as "CalDAV." Copy the resulting password and paste it into Thunderbird.
.. figure:: /_static/images/nextcloud/native-nextcloud-integration-macos-step3.1.png
:width: 60%
:alt: nextcloud app password
.. figure:: /_static/images/nextcloud/thunderbird-contact-step3.png
:width: 40%
:alt: thunderbird add password
Your Nextcloud contacts will now sync with Thunderbird.

16
site/source/service-guides/nextcloud/nextcloud-setup/index.rst Normal file
View File

@@ -0,0 +1,16 @@
.. _nextcloud-setup:
======================
Nextcloud Device Setup
======================
Connection guides by Device. This will guide you through initial setup and syncing configurations.
.. toctree::
:maxdepth: 1
nextcloud-linux
nextcloud-mac
nextcloud-windows
nextcloud-android
nextcloud-ios

143
site/source/service-guides/nextcloud/nextcloud-setup/nextcloud-android.rst Normal file
View File

@@ -0,0 +1,143 @@
.. _nextcloud-android:
===================
Nextcloud - Android
===================
.. contents::
:depth: 2
:local:
Initial Config
--------------
It is advised to setup your Nextcloud devices on LAN (if available) for the best experience. Once set up, Tor can be used for remote syncing, but remember that large files will likely fail or take a very long time, so it is best to use remote sync only for low-bandwidth activity, such as Calendar, Contacts, Tasks, and Notes. Streaming your music is also possible. Later in 2023, new connection options will unlock Nextcloud's full feature-set.
Nextcloud App
-------------
The latest version of the official Nextcloud client is available on their `download page <https://nextcloud.com/install/#install-clients>`_. This is for file syncing and account management.
LAN Setup
=========
Make sure you have first set up :ref:`LAN access<ca-android>`.
1. Open Nextcloud via your server's Services -> Nextcloud -> Launch UI
2. Log in and select the top right icon -> Personal Settings:
.. figure:: /_static/images/services/nextcloud/web-step1-personal_settings.png
:width: 30%
:alt: Nextcloud: > Personal Settings
3. Select the hamburger (3 lines) menu:
.. figure:: /_static/images/services/nextcloud/web-step2-ps-profile.png
:width: 30%
:alt: Nextcloud: Personal Settings > Hamburger menu
4. Select Security:
.. figure:: /_static/images/services/nextcloud/web-step3-security.png
:width: 30%
:alt: Nextcloud: Personal Settings > Security
5. Under `Devices & sessions`, give this Nextcloud mobile app a session name, such as "Mobile" and tap `Create new app password`:
.. figure:: /_static/images/services/nextcloud/web-step4-new_session.png
:width: 30%
:alt: Nextcloud: Devices & sessions > Create new app password
6. Tap `Show QR code for mobile apps`:
.. figure:: /_static/images/services/nextcloud/web-step5-show_qr_code.png
:width: 30%
:alt: Nextcloud Show new session's QR code
7. The new session's QR code will be displayed:
.. figure:: /_static/images/services/nextcloud/web-step6-qr_code_shown.png
:width: 30%
:alt: Nextcloud: New session's QR code is shown
8. Download and install the appropriate desktop client for your Android device from https://nextcloud.com/install/#install-clients
9. Open the Nextcloud client on your Android device and tap "Log in"
.. figure:: /_static/images/services/nextcloud/step1-login.png
:width: 30%
:alt: Nextcloud mobile app Log in
10. Tap the QR code icon:
.. figure:: /_static/images/services/nextcloud/step2-read_qrcode.png
:width: 30%
:alt: Nextcloud mobile app QR Code button
11. Scan the QR code presented in Step 7.
.. note::
Here you may see an error about the Nextcloud app being unable to find the host that was decoded from the QR code:
.. figure:: /_static/images/services/nextcloud/pitfall1-could_not_connect_to_host-wifi-mdns-orbot.png
:width: 30%
:alt: Nextcloud mobile app error: Could not find host
If you see this message, you may be on an Android version that does not support mDNS .local name resolution (it is available on Android 13+ and some builds of Android 12, but not all. The other possibility is that your WiFi network is not properly "bridged" with the ethernet network that your Start9 server is on, or you lack WiFi connectivity to your network in general.
Alternatively, you may see a warning about an untrusted certificate:
.. figure:: /_static/images/services/nextcloud/pitfall2-untrusted_cert.png
:width: 30%
:alt: Nextcloud mobile app QR Code button
In this case, make sure you have :ref:`added your server's CA certificate to the Android trust store<ca-android>` as noted at the top of the `LAN Setup` section of this guide, close the Nextcloud mobile app and try again. Otherwise, proceed to the next step.
12. Android may ask you about Storage permissions. Grant "Full access":
.. figure:: /_static/images/services/nextcloud/step3-grant_file_access.png
:width: 30%
:alt: Nextcloud Storage permissions
13. 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, tap "Connect"
14. Files will begin to sync immediately and you will see a green check when this is complete.
15. 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 :ref:`Orbot running<tor-android>`.
1. First, add Nextcloud to your Orbot apps list.
2. Tap the account in the top-right, then "Add Account."
3. On the following screen, tap "Log in," then enter your Nextcloud Tor server address, which you can copy from Nextcloud -> Interfaces - Tor. This must start with ``http://`` and end with ``.onion``. tap Next.
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 tapping into the newly created account in the app.
Device Integration
------------------
In order to sync calendars and contacts with your Android device, follow the steps below, which are adapted from the `Official Nextcloud guide <https://docs.nextcloud.com/server/25/user_manual/en/groupware/sync_android.html>`_. First head into the top-righthand menu of your Nextcloud's WebUI and click "Apps," then search for and install the Calendar and/or Contacts Apps.
1. Download the WebDAV sync management client `DAVx5 <https://www.davx5.com/download/>`_ from your app store of choice, such as F-Droid or the Play Store.
2. Add account:
- If you are on Android 12+ and already have the Nextcloud file-syncing app (recommended - guide above), then open it and enter the "Settings" menu from the top-lefthand hamburger (3 lines) menu. Then under the section titled, "More," tap "Sync Calendar & Contacts."
- This will open Nextcloud's WebFlow login in a browser, where you will need to log in and "Grant Access" - you will then be returned to DAVx5
- Set an account name when asked, then set "Contact Group Method" to "Groups are per-contact categories" - DAVx5 will close and Nextcloud will reappear.
- Manually launch DAVx5 again and top on the account that was just created. Grant access to Calendars and Contacts when requested, and optionally tasks, if you added that feature in setup. Choose the address books and calendars you wish to sync and you're done!
- If you are NOT using the Nextcloud app already, then open DAVx5 and after going through the introduction (optionally selecting additional features), tap the "+" icon to add a new account, then select "Login with URL and user name," and fill in the following fields:
- Base URL - Enter your Nextcloud WebDAV Base LAN URL (found in "Properties" in the Nextcloud service page).
- User name - Your Nextcloud user (defaults are found in "Properties" on your Nextcloud service page)
- Password - Your Nextcloud user's password (defaults are found in "Properties" on your Nextcloud service page)
- If given the option, select "Groups are per-contact categories," then tap "Login." Select the data you want to sync, grant access for contacts, calendars, and optionally tasks if you added that feature in setup. That's it, you're done!
.. tip:: You may also wish to add the `ICSx5 <https://icsx5.bitfire.at/>`_ app, which allows subscription to remote WebCal or local iCal files (such as public event schedules, iCloud/Google calendars, etc). It can be found in your favorite app store.

118
site/source/service-guides/nextcloud/nextcloud-setup/nextcloud-ios.rst Normal file
View File

@@ -0,0 +1,118 @@
.. _nextcloud-ios:
===============
Nextcloud - iOS
===============
.. contents::
:depth: 2
:local:
Initial Config
--------------
It is advised to setup your Nextcloud devices on LAN (if available) for the best experience. Once set up, Tor can be used for remote syncing, but remember that large files will likely fail or take a very long time, so it is best to use remote sync only for low-bandwidth activity, such as Calendar, Contacts, Tasks, and Notes. Streaming your music is also possible. Later in 2023, new connection options will unlock Nextcloud's full feature-set.
Standalone Client
-----------------
The latest version of the official Nextcloud client is available on their `download page <https://nextcloud.com/install/#install-clients>`_.
LAN Setup
=========
Make sure you have first set up :ref:`LAN access<ca-ios>`.
1. Download the iOS Nextcloud client from `App Store <https://apps.apple.com/us/app/nextcloud/id1125420102>`_.
2. Open the client and tap "Log In".
.. figure:: /_static/images/nextcloud/nextcloud-iOS-step2.png
:width: 30%
:alt: nextcloud-ios-login
3. 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-ios-login
4. Enter your LAN address under "Server Address" and tap "Next".
.. figure:: /_static/images/nextcloud/nextcloud-iOS-step4.png
:width: 30%
:alt: nextcloud-ios-login
5. You will be shown the "Connect to your account" screen, and then click "Log In" and "Grant Access".
.. figure:: /_static/images/nextcloud/nextcloud-iOS-step5.png
:width: 30%
:alt: nextcloud-ios-login
.. figure:: /_static/images/nextcloud/nextcloud-mac-step3-lan.png
:width: 60%
:alt: nextcloud-ios-login
6. Next, you will be asked to enter the username and password, which can be found on the startOS Nextcloud Service page under the "Properties" tab.
.. figure:: /_static/images/nextcloud/nextcloud-iOS-step5.png
:width: 30%
:alt: nextcloud-ios-login
7. The account access page will be displayed, tap "Grant access".
.. figure:: /_static/images/nextcloud/nextcloud-iOS-step6.png
:width: 30%
:alt: nextcloud-ios-login
8. Files will begin syncing immediately, and you will see your username and account icon in the top left corner.
.. figure:: /_static/images/nextcloud/nextcloud-iOS-step7.png
:width: 30%
:alt: nextcloud-ios-login
9. That's it! From this mobile client you can receive 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-ios>`.
1. Click the account in the top left again, then "Add Account."
2. On the following screen, click "Log in," then enter your Nextcloud Tor server address, which you can copy from Nextcloud -> Interfaces - Tor. This must start with `http://` and end with .onion. Click Next.
3. 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.
4. 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.
Device Integration
------------------
In order to sync calendars and contacts with your iOS device, follow the steps below, which are adapted from the `Official Nextcloud guide <https://docs.nextcloud.com/server/25/user_manual/en/groupware/sync_ios.html>`_.
First head into the top-righthand menu of your Nextcloud's WebUI and click "Apps," then search for and install the Calendar and/or Contacts Apps. Next folow guide for iOS.
.. figure:: /_static/images/nextcloud/nextcloud-iOS-native.png
:width: 60%
:alt: nextcloud account settings
1. Open the "Settings" app on iOS device.
.. note:: You will need to perform 2 individual setups, one for Calendar and one for Contacts.
2. Select "Calendar" (or "Contacts") -> "Accounts" -> "Add Account" -> "Other" -> "either CalDAV (for Calendar setup) or CardDAV (for Contacts setup)". Return to this step after completing one in order to add the other.
.. figure:: /_static/images/nextcloud/nextcloud-iOS-native-step1.png
:width: 60%
:alt: nextcloud account settings
3. Enter the following fields and tap "Next":
- Server - Enter your Nextcloud WebDAV Base LAN URL (found in "Properties" in the Nextcloud service page).
- User name - The default user is "embassy" but this is your user within Nextcloud, so be sure it is the correct user if you have more than one.
- Password - Your Nextcloud user's password (Default found in "Properties" in the Nextcloud service page).
- Description - Anything to describe this account, such as "Nextcloud CalDAV".
.. figure:: /_static/images/nextcloud/nextcloud-iOS-native-step2.png
:width: 30%
:alt: nextcloud account settings
4. If you get a warning about verifying the server identity, it is safe to "Continue." Add the apps you want to use, such as Calendars, Contacts, and/or Reminders, then tap "Save."
- That's it! Go back to step 2 above to set up your other account (CalDAV / CardDAV).

141
site/source/service-guides/nextcloud/nextcloud-setup/nextcloud-linux.rst Normal file
View File

@@ -0,0 +1,141 @@
.. _nextcloud-linux:
=================
Nextcloud - Linux
=================
.. contents::
:depth: 2
:local:
Initial Config
--------------
It is advised to setup your Nextcloud devices on LAN (if available) for the best experience. Once set up, Tor can be used for remote syncing, but remember that large files will likely fail or take a very long time, so it is best to use remote sync only for low-bandwidth activity, such as Calendar, Contacts, Tasks, and Notes. Streaming your music is also possible. Later in 2023, new connection options will unlock Nextcloud's full feature-set.
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:`trust your Root CA<ca-linux>`.
The following desktop environments support integrated account syncing, including Nextcloud:
- Gnome (Ubuntu default)
- Cinnamon (Linux Mint default)
- KDE
- Budgie
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 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
================================
This is Nextcloud's official client application for file syncing and account management. It is available in your favorite package manager (usually as `nextcloud`). You can also see this `full list of available packages <https://help.nextcloud.com/t/linux-packages-status/>`_. or you can get the latest version as an AppImage from the `Download for Desktop <https://nextcloud.com/install/#install-clients>`_ section of Nextcloud's website.
LAN Setup
.........
Make sure you have first set up :ref:`trusted your Root CA<ca-linux>`.
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 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 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.

185
site/source/service-guides/nextcloud/nextcloud-setup/nextcloud-mac.rst Normal file
View File

@@ -0,0 +1,185 @@
.. _nextcloud-mac:
=================
Nextcloud - MacOS
=================
.. contents::
:depth: 3
:local:
Initial Config
--------------
It is advised to setup your Nextcloud devices on LAN (if available) for the best experience. Once set up, Tor can be used for remote syncing, but remember that large files will likely fail or take a very long time, so it is best to use remote sync only for low-bandwidth activity, such as Calendar, Contacts, Tasks, and Notes. Streaming your music is also possible. Later in 2023, new connection options will unlock Nextcloud's full feature-set.
Native Desktop Integration
--------------------------
The smoothest experience will be using direct account integration with your Mac. First head into the top-righthand menu of your Nextcloud's WebUI and click "Apps," then search for and install the Calendar and/or Contacts Apps if you don't have them already (these are installed by default on the latest Nextcloud for StartOS). The steps below are adapted from the `Official Nextcloud guide <https://docs.nextcloud.com/server/24/user_manual/en/groupware/sync_osx.html>`_ and updated for the latest MacOS (Ventura). Make sure you have first set up :ref:`LAN access<ca-mac>`.
.. tabs::
.. group-tab:: Ventura
1. Open the "System Settings" and select "Internet Accounts," click "Add Account." and then select "Add Other Account".
.. figure:: /_static/images/nextcloud/native-nextcloud-integration-macos-step1.png
:width: 60%
:alt: macOS add account
.. figure:: /_static/images/nextcloud/native-nextcloud-integration-macos-step1.2.png
:width: 60%
:alt: macOS add account
2. Select CalDAV for calendar setup or CardDAV for contacts setup. If you want to do both, you will need to return to this step after finishing the setup of the first.
.. note:: You will need to perform 2 individual setups, one for Calendar and one for Contacts.
.. figure:: /_static/images/nextcloud/native-nextcloud-integration-macos-step2.png
:width: 60%
:alt: macOS select account
3. Select "Advanced" from the "Account Type" dropdown menu and fill in the following fields.
.. figure:: /_static/images/nextcloud/native-nextcloud-integration-macos-step3.png
:width: 60%
:alt: macOS setup account
- Username - The default user is "admin," but this is your user within Nextcloud, so be sure it is the correct user if you have more than one
- Password - In your Nextcloud WebUI, visit the top-right-hand menu and select "Personal Settings" -> "Security." At the bottom, under Devices & Sessions, create a new app password with a name of your choice, such as "MacCalDAV." Then, copy the resulting password into your Mac's account configuration.
.. figure:: /_static/images/nextcloud/native-nextcloud-integration-macos-step3.1.png
:width: 60%
:alt: nextcloud app password
- Server Address - copy your LAN address from the "Interfaces" section of your Nextcloud service page then paste.
.. figure:: /_static/images/nextcloud/native-nextcloud-integration-macos-step3.2.png
:width: 60%
:alt: nextcloud app password
- Server Path - You can find complete path in Nextcloud -> Calendar settings -> Copy iOS/macOS CalDav address. For setting up contacts/CardDav use the same path.
.. figure:: /_static/images/nextcloud/native-nextcloud-integration-macos-step3.3.png
:width: 60%
:alt: nextcloud app password
- Port - Set port to `443`.
4. Click "Sign In."
- You can now select the apps you want to use on your Mac, such as Calendars, Reminders.
- Return to Step 3 to set up CalDAV/CardDAV, whichever you have not done yet.
.. group-tab:: Pre-Ventura
1. Open the "System Settings" and select "Internet Accounts," then click "Add Account."
2. Select "Add Other Account"
.. note:: You will need to perform 2 individual setups, one for Calendar and one for Contacts.
3. Select CalDAV for Calendar setup OR CardDAV for Contacts setup. If you want to do both, you will need to return to this step after finishing setup of the first.
4. Select "Manual" from the "Account Type" dropdown menu and fill in the following fields:
- Username - The default user is "admin," but this is your user within Nextcloud, so be sure it is the correct user if you have more than one
- Password - In your Nextcloud WebUI, visit the top-righthand menu and select "Personal Settings" -> "Security." At the bottom, under Devices & Sessions, create a new app password with a name of your choice, such as "MacCalDAV," and then copy the resulting password into your Mac's account config
- Server Address - copy your LAN address from the "Interfaces" section of your Nextcloud service page then add `/remote.php/dav` after `.local`
5. Click "Sign In."
- You can now select the apps you want to use on your Mac, such as Calendars, Reminders, or Contacts
- Return to Step 3 to continue setup
Standalone Clients
------------------
.. note:: The desktop version of NextCloud doesn't have much of a user interface. Once installed, it solely lives in the top right hand corner of the Mac desktop in the navbar, near the WiFi icon. When it's synced, the icon turns into a checkmark with a circle around it.
For those that prefer to use a desktop client.
File Syncing - Nextcloud Desktop
================================
This is Nextcloud's official client application for file syncing and account management. The latest version of the official Nextcloud client is available on their `download page <https://nextcloud.com/install/#install-clients>`_.
LAN Setup
.........
Make sure you have first set up :ref:`LAN access<ca-mac>`. Then do the following:
1. Download the appropriate desktop client from the `Nextcloud website <https://nextcloud.com/install/#install-clients>`_.
2. Open the client and click "Log In".
.. figure:: /_static/images/nextcloud/nextcloud-mac-step2.png
:width: 40%
:alt: nextcloud-login
3. 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-login
4. Enter your LAN address under "Server Address" and click "Next".
.. figure:: /_static/images/nextcloud/nextcloud-mac-step4.png
:width: 40%
:alt: nextcloud-login
5. 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: 40%
:alt: nextcloud-login
6. 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-mac-step6.png
:width: 60%
:alt: nextcloud-login
7. Files will begin to sync immediately and you will see a green check when this is complete.
.. figure:: /_static/images/nextcloud/nextcloud-mac-step7.png
:width: 50%
:alt: nextcloud-login
8. That's it! From this desktop client you can receive 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-mac>`.
1. On your desktop application, click the account in the top left -> Settings.
.. figure:: /_static/images/nextcloud/nextcloud-mac-tor1.png
:width: 40%
:alt: nextcloud-login
2. On the following screen, click "Network" tab and then “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-mac-tor2.png
:width: 40%
:alt: nextcloud-login
3. Close the Settings screen and click the account in the top left again, then “Add Account.”
.. figure:: /_static/images/nextcloud/nextcloud-mac-tor3.png
:width: 40%
:alt: nextcloud-login
4. On the following screen, click “Log in,” then enter your Nextcloud Tor server address, which you can copy from Nextcloud -> Interfaces - Tor. This must start with http:// and end with .onion. Click Next.
.. figure:: /_static/images/nextcloud/nextcloud-mac-step2.png
:width: 40%
:alt: nextcloud-login
.. figure:: /_static/images/nextcloud/nextcloud-mac-step4.png
:width: 40%
:alt: nextcloud-login
5. 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.
6. 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.

66
site/source/service-guides/nextcloud/nextcloud-setup/nextcloud-windows.rst Normal file
View File

@@ -0,0 +1,66 @@
.. _nextcloud-windows:
===================
Nextcloud - Windows
===================
.. contents::
:depth: 2
:local:
Initial Config
--------------
It is advised to setup your Nextcloud devices on LAN (if available) for the best experience. Once set up, Tor can be used for remote syncing, but remember that large files will likely fail or take a very long time, so it is best to use remote sync only for low-bandwidth activity, such as Calendar, Contacts, Tasks, and Notes. Streaming your music is also possible. Later in 2023, new connection options will unlock Nextcloud's full feature-set.
Native Desktop Integration
--------------------------
If you prefer to use Microsoft's integrated Calendar and Contacts apps with your Windows machine, you can integrate directly. First head into the top-righthand menu of your Nextcloud's WebUI and click "Apps," then search for and install the Calendar and/or Contacts Apps. The steps below are adapted from the `Official Nextcloud guide <https://docs.nextcloud.com/server/24/user_manual/en/groupware/sync_windows10.html>`_. Make sure you have first set up :ref:`LAN access<ca-windows>`.
1. Launch the Windows Calendar app and click the gear icon (Settings), then select "Manage Accounts."
2. Select "Add Account" and choose "iCloud" (don't worry, it won't *really* be iCloud).
3. Enter an email, username and password. None of this information has to be valid and it will all be changed in the upcoming steps. Click "Sign In" (or "Done" in Win10).
4. In the "Manage Accounts" menu, click on the account just created and select "Change Settings," and then "Change mailbox sync settings" (at the bottom of the page).
5. Scroll to the bottom again and fill in the following fields (as desired):
- Calendar Server (CalDAV) - This link can be copy-pasted by clicking your Nextcloud Calendar app's "Calendar Settings" in the bottom-left, then "Copy primary CalDAV address" at the bottom of the expanded menu.
- Contacts Server (CardDAV) - This link can be copy-pasted by clicking your Nextcloud Contacts app's "Contacts Settings" in the bottom-left, then the kebab (3 dots) menu next to "Contacts," and finally "Copy Link" at the top of the resulting menu.
6. Click "Done."
- You should now be able to sync your native Windows Contacts and/or Calendar apps with the associated Nextcloud apps.
Standalone Clients
------------------
File Syncing - Nextcloud Desktop
================================
This is Nextcloud's official client application for file syncing and account management. The latest version of the official Nextcloud client is available on their `download page <https://nextcloud.com/install/#install-clients>`_.
LAN Setup
.........
Make sure you have first set up :ref:`LAN access<ca-windows>`. Then do the following:
1. Download the appropriate desktop client from https://nextcloud.com/install/#install-clients
2. Open the client and click "Log In"
3. From your server's Nextcloud Service page, go to "Interfaces" and copy the LAN address
4. Enter your LAN address under "Server Address" and click "Next"
5. You will be asked to Trust your server's certificate, which is safe to do as you generate and sign this during LAN Setup
6. Tick the box for "Trust this certificate anyway" and click "Next"
7. 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
8. 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"
9. Files will begin to sync immediately and you will see a green check when this is complete.
10. 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-windows>`.
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 Nextcloud -> Interfaces - Tor. This must start with `http://` and end with .onion. Click Next.
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.