.. _nextcloud-windows: =================== Nextcloud - Windows =================== .. contents:: :depth: 2 :local: Initial Config -------------- During initial configuration, notice the setting called "Enable Tor". - If OFF: You can use Nextcloud from the browser or from any mobile or desktop client using its .local URL while connected to the same Local Area Network (LAN) as your Embassy. Note: .onion will not work at all. Make sure you have setup :ref:`LAN access` on your system. - If ON: You can use NextCloud from the browser by visiting its .onion or .local URL. You can also use Nextcloud from any mobile or desktop client using its .onion URL. Note: .local will not work from mobile or desktop clients. Make sure you have :ref:`Tor running on your device`. The default is Off for two reasons: 1. Initial sync over LAN will be much faster. 2. To use Tor with Nextcloud's desktop clients, you must first change a setting in the desktop client that can only be changed if you are already logged in. In other words, you must first login over LAN in order to be able to login over Tor. 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 `_. Make sure you have first set up :ref:`LAN access`. 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 `_. LAN Setup ......... Make sure you have first set up :ref:`LAN access`. 1. Download the appropriate desktop client from https://nextcloud.com/install/#install-clients 2. Open the client and click "Log In" 3. From your Embassy'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 Embassy'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`. 1. First, enable Tor in the Nextcloud Config on Embassy, Services -> Nextcloud -> Config -> Connection Settings -> Connection Type -> LAN and Tor. 2. 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. 3. Close the Settings screen and click the account in the top left again, then "Add Account." 4. 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. 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. Calendar & Contacts Syncing - Thunderbird ========================================= If you wish to use a standalone client for Calendar and Contacts, we recommend Mozilla's `Thunderbird `_. 1. Install the Contacts and Calendar apps in Nextcloud. 2. Make sure you are on Thunderbird version 102.3.0 or greater and then import your LAN certificate: - :ref:`Download your certificate` and then add it in "Thunderbird -> Settings -> Privacy & Security -> Manage Certificates -> Authorities tab -> Import" - Check the box for "This certificate can identify websites" 3. Download the TBSync and Provider for CalDAV & CardDAV add-ons by searching for them in the "Tools -> Add-ons and Themes" menu. 4. Go back to the "Tools -> Add-ons and Themes" menu and click the 'wrench' icon next to TBSync. 5. Click "Account Actions" in the bottom left of the resulting screen, then "Add New Account -> CalDAV & CardDAV." 6. Select "Automatic." 7. Enter a name for your account, your nextcloud user name (found in Properties, default is 'embassy'), password (found in Properties), and server LAN address (found in Interfaces, ending in `.local`) - then click "Next." 8. After connecting, click "Finish." 9. In the resulting window, click "Enable and synchronize this account." 10. Select the items you want to sync, such as contacts and a calendar.