From 0735183242ed16890d8c82456886587ef7128317 Mon Sep 17 00:00:00 2001 From: kn0wmad <39687477+kn0wmad@users.noreply.github.com> Date: Wed, 11 Jan 2023 21:31:26 -0700 Subject: [PATCH] Feat/nextcloud guides (#260) * Basic Linux guides for Nextcloud * Basic Mac, Windows, Android, iOS guides for Nextcloud * Update system-wide certs for Linux and all NC guides * Update Vaultwarden on Mac over Tor instruction * Update Vaultwarden docs with intro and admin console instruction * Final updates on NC guides * Fix iOS error --- poetry.lock | 128 +++--------------- .../connecting-lan/lan-os/lan-linux.rst | 44 ++++-- .../user-manual/service-guides/index.rst | 3 +- .../service-guides/nextcloud/index.rst | 16 +++ .../nextcloud/nextcloud-android.rst | 80 +++++++++++ .../nextcloud/nextcloud-ios.rst | 76 +++++++++++ .../nextcloud/nextcloud-linux.rst | 89 ++++++++++++ .../nextcloud/nextcloud-mac.rst | 99 ++++++++++++++ .../nextcloud/nextcloud-windows.rst | 95 +++++++++++++ .../service-guides/vaultwarden.rst | 14 +- 10 files changed, 520 insertions(+), 124 deletions(-) create mode 100644 site/source/user-manual/service-guides/nextcloud/index.rst create mode 100644 site/source/user-manual/service-guides/nextcloud/nextcloud-android.rst create mode 100644 site/source/user-manual/service-guides/nextcloud/nextcloud-ios.rst create mode 100644 site/source/user-manual/service-guides/nextcloud/nextcloud-linux.rst create mode 100644 site/source/user-manual/service-guides/nextcloud/nextcloud-mac.rst create mode 100644 site/source/user-manual/service-guides/nextcloud/nextcloud-windows.rst diff --git a/poetry.lock b/poetry.lock index 03781b7..98d4b60 100644 --- a/poetry.lock +++ b/poetry.lock @@ -128,7 +128,7 @@ python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*" [[package]] name = "importlib-metadata" -version = "5.2.0" +version = "6.0.0" description = "Read metadata from Python packages" category = "main" optional = false @@ -233,7 +233,7 @@ python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*" [[package]] name = "pygments" -version = "2.13.0" +version = "2.14.0" description = "Pygments is a syntax highlighting package written in Python." category = "main" optional = false @@ -622,7 +622,7 @@ socks = ["PySocks (>=1.5.6,!=1.5.7,<2.0)"] [[package]] name = "watchdog" -version = "2.2.0" +version = "2.2.1" description = "Filesystem events monitoring" category = "dev" optional = false @@ -665,33 +665,16 @@ argh = [ {file = "argh-0.26.2-py2.py3-none-any.whl", hash = "sha256:a9b3aaa1904eeb78e32394cd46c6f37ac0fb4af6dc488daa58971bdc7d7fcaf3"}, {file = "argh-0.26.2.tar.gz", hash = "sha256:e9535b8c84dc9571a48999094fda7f33e63c3f1b74f3e5f3ac0105a58405bb65"}, ] -atomicwrites = [ - {file = "atomicwrites-1.4.1.tar.gz", hash = "sha256:81b2c9071a49367a7f770170e5eec8cb66567cfbbc8c73d20ce5ca4a8d71cf11"}, -] -attrs = [ - {file = "attrs-22.2.0-py3-none-any.whl", hash = "sha256:29e95c7f6778868dbd49170f98f8818f78f3dc5e0e37c0b1f474e3561b240836"}, - {file = "attrs-22.2.0.tar.gz", hash = "sha256:c9227bfc2f01993c03f68db37d1d15c9690188323c067c641f1a35ca58185f99"}, -] -babel = [ - {file = "Babel-2.11.0-py3-none-any.whl", hash = "sha256:1ad3eca1c885218f6dce2ab67291178944f810a10a9b5f3cb8382a5a232b64fe"}, - {file = "Babel-2.11.0.tar.gz", hash = "sha256:5ef4b3226b0180dedded4229651c8b0e1a3a6a2837d45a073272f313e4cf97f6"}, -] +atomicwrites = [] +attrs = [] +babel = [] beautifulsoup4 = [ {file = "beautifulsoup4-4.11.1-py3-none-any.whl", hash = "sha256:58d5c3d29f5a36ffeb94f02f0d786cd53014cf9b3b3951d42e0080d8a9498d30"}, {file = "beautifulsoup4-4.11.1.tar.gz", hash = "sha256:ad9aa55b65ef2808eb405f46cf74df7fcb7044d5cbc26487f96eb2ef2e436693"}, ] -certifi = [ - {file = "certifi-2022.12.7-py3-none-any.whl", hash = "sha256:4ad3232f5e926d6718ec31cfc1fcadfde020920e278684144551c91769c7bc18"}, - {file = "certifi-2022.12.7.tar.gz", hash = "sha256:35824b4c3a97115964b408844d64aa14db1cc518f6562e8d7261699d1350a9e3"}, -] -charset-normalizer = [ - {file = "charset-normalizer-2.1.1.tar.gz", hash = "sha256:5a3d016c7c547f69d6f81fb0db9449ce888b418b5b9952cc5e6e66843e9dd845"}, - {file = "charset_normalizer-2.1.1-py3-none-any.whl", hash = "sha256:83e9a75d1911279afd89352c68b45348559d1fc0506b054b346651b5e7fee29f"}, -] -colorama = [ - {file = "colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6"}, - {file = "colorama-0.4.6.tar.gz", hash = "sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44"}, -] +certifi = [] +charset-normalizer = [] +colorama = [] commonmark = [ {file = "commonmark-0.9.1-py2.py3-none-any.whl", hash = "sha256:da2f38c92590f83de410ba1a3cbceafbc74fee9def35f9251ba9a971d6d66fd9"}, {file = "commonmark-0.9.1.tar.gz", hash = "sha256:452f9dc859be7f06631ddcb328b6919c67984aca654e5fefb3914d54691aed60"}, @@ -700,18 +683,12 @@ docutils = [ {file = "docutils-0.17.1-py2.py3-none-any.whl", hash = "sha256:cf316c8370a737a022b72b56874f6602acf974a37a9fba42ec2876387549fc61"}, {file = "docutils-0.17.1.tar.gz", hash = "sha256:686577d2e4c32380bb50cbb22f575ed742d58168cee37e99117a854bcd88f125"}, ] -idna = [ - {file = "idna-3.4-py3-none-any.whl", hash = "sha256:90b77e79eaa3eba6de819a0c442c0b4ceefc341a7a2ab77d7562bf49f425c5c2"}, - {file = "idna-3.4.tar.gz", hash = "sha256:814f528e8dead7d329833b91c5faa87d60bf71824cd12a7530b5526063d02cb4"}, -] +idna = [] imagesize = [ {file = "imagesize-1.4.1-py2.py3-none-any.whl", hash = "sha256:0d8d18d08f840c19d0ee7ca1fd82490fdc3729b7ac93f49870406ddde8ef8d8b"}, {file = "imagesize-1.4.1.tar.gz", hash = "sha256:69150444affb9cb0d5cc5a92b3676f0b2fb7cd9ae39e947a5e11a36b4497cd4a"}, ] -importlib-metadata = [ - {file = "importlib_metadata-5.2.0-py3-none-any.whl", hash = "sha256:0eafa39ba42bf225fc00e67f701d71f85aead9f878569caf13c3724f704b970f"}, - {file = "importlib_metadata-5.2.0.tar.gz", hash = "sha256:404d48d62bba0b7a77ff9d405efd91501bef2e67ff4ace0bed40a0cf28c3c7cd"}, -] +importlib-metadata = [] jinja2 = [ {file = "Jinja2-3.0.3-py3-none-any.whl", hash = "sha256:077ce6014f7b40d03b47d1f1ca4b0fc8328a692bd284016f806ed0eaca390ad8"}, {file = "Jinja2-3.0.3.tar.gz", hash = "sha256:611bb273cd68f3b993fabdc4064fc858c5b47a973cb5aa7999ec1ba405c87cd7"}, @@ -761,14 +738,8 @@ markupsafe = [ {file = "MarkupSafe-2.1.1-cp39-cp39-win_amd64.whl", hash = "sha256:46d00d6cfecdde84d40e572d63735ef81423ad31184100411e6e3388d405e247"}, {file = "MarkupSafe-2.1.1.tar.gz", hash = "sha256:7f91197cc9e48f989d12e4e6fbc46495c446636dfc81b9ccf50bb0ec74b91d4b"}, ] -more-itertools = [ - {file = "more-itertools-9.0.0.tar.gz", hash = "sha256:5a6257e40878ef0520b1803990e3e22303a41b5714006c32a3fd8304b26ea1ab"}, - {file = "more_itertools-9.0.0-py3-none-any.whl", hash = "sha256:250e83d7e81d0c87ca6bd942e6aeab8cc9daa6096d12c5308f3f92fa5e5c1f41"}, -] -packaging = [ - {file = "packaging-22.0-py3-none-any.whl", hash = "sha256:957e2148ba0e1a3b282772e791ef1d8083648bc131c8ab0c1feba110ce1146c3"}, - {file = "packaging-22.0.tar.gz", hash = "sha256:2198ec20bd4c017b8f9717e00f0c8714076fc2fd93816750ab48e2c41de2cfd3"}, -] +more-itertools = [] +packaging = [] pathtools = [ {file = "pathtools-0.1.2.tar.gz", hash = "sha256:7c35c5421a39bb82e58018febd90e3b6e5db34c5443aaaf742b3f33d4655f1c0"}, ] @@ -783,18 +754,12 @@ py = [ {file = "py-1.11.0-py2.py3-none-any.whl", hash = "sha256:607c53218732647dff4acdfcd50cb62615cedf612e72d1724fb1a0cc6405b378"}, {file = "py-1.11.0.tar.gz", hash = "sha256:51c75c4126074b472f746a24399ad32f6053d1b34b68d2fa41e558e6f4a98719"}, ] -pygments = [ - {file = "Pygments-2.13.0-py3-none-any.whl", hash = "sha256:f643f331ab57ba3c9d89212ee4a2dabc6e94f117cf4eefde99a0574720d14c42"}, - {file = "Pygments-2.13.0.tar.gz", hash = "sha256:56a8508ae95f98e2b9bdf93a6be5ae3f7d8af858b43e02c5a2ff083726be40c1"}, -] +pygments = [] pytest = [ {file = "pytest-5.4.3-py3-none-any.whl", hash = "sha256:5c0db86b698e8f170ba4582a492248919255fcd4c79b1ee64ace34301fb589a1"}, {file = "pytest-5.4.3.tar.gz", hash = "sha256:7979331bfcba207414f5e1263b5a0f8f521d0f457318836a7355531ed1a4c7d8"}, ] -pytz = [ - {file = "pytz-2022.7-py2.py3-none-any.whl", hash = "sha256:93007def75ae22f7cd991c84e02d434876818661f8df9ad5df9e950ff4e52cfd"}, - {file = "pytz-2022.7.tar.gz", hash = "sha256:7ccfae7b4b2c067464a6733c6261673fdb8fd1be905460396b97a073e9fa683a"}, -] +pytz = [] pyyaml = [ {file = "PyYAML-6.0-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:d4db7c7aef085872ef65a8fd7d6d09a14ae91f691dec3e87ee5ee0539d516f53"}, {file = "PyYAML-6.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:9df7ed3b3d2e0ecfe09e14741b857df43adb5a3ddadc919a2d94fbdf78fea53c"}, @@ -803,13 +768,6 @@ pyyaml = [ {file = "PyYAML-6.0-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:f84fbc98b019fef2ee9a1cb3ce93e3187a6df0b2538a651bfb890254ba9f90b5"}, {file = "PyYAML-6.0-cp310-cp310-win32.whl", hash = "sha256:2cd5df3de48857ed0544b34e2d40e9fac445930039f3cfe4bcc592a1f836d513"}, {file = "PyYAML-6.0-cp310-cp310-win_amd64.whl", hash = "sha256:daf496c58a8c52083df09b80c860005194014c3698698d1a57cbcfa182142a3a"}, - {file = "PyYAML-6.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:d4b0ba9512519522b118090257be113b9468d804b19d63c71dbcf4a48fa32358"}, - {file = "PyYAML-6.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:81957921f441d50af23654aa6c5e5eaf9b06aba7f0a19c18a538dc7ef291c5a1"}, - {file = "PyYAML-6.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:afa17f5bc4d1b10afd4466fd3a44dc0e245382deca5b3c353d8b757f9e3ecb8d"}, - {file = "PyYAML-6.0-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:dbad0e9d368bb989f4515da330b88a057617d16b6a8245084f1b05400f24609f"}, - {file = "PyYAML-6.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:432557aa2c09802be39460360ddffd48156e30721f5e8d917f01d31694216782"}, - {file = "PyYAML-6.0-cp311-cp311-win32.whl", hash = "sha256:bfaef573a63ba8923503d27530362590ff4f576c626d86a9fed95822a8255fd7"}, - {file = "PyYAML-6.0-cp311-cp311-win_amd64.whl", hash = "sha256:01b45c0191e6d66c470b6cf1b9531a771a83c1c4208272ead47a3ae4f2f603bf"}, {file = "PyYAML-6.0-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:897b80890765f037df3403d22bab41627ca8811ae55e9a722fd0392850ec4d86"}, {file = "PyYAML-6.0-cp36-cp36m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:50602afada6d6cbfad699b0c7bb50d5ccffa7e46a3d738092afddc1f9758427f"}, {file = "PyYAML-6.0-cp36-cp36m-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:48c346915c114f5fdb3ead70312bd042a953a8ce5c7106d5bfb1a5254e47da92"}, @@ -869,17 +827,11 @@ sphinx-collapse = [ {file = "sphinx_collapse-0.1.2-py3-none-any.whl", hash = "sha256:7a2082da3c779916cc4c4d44832db3522a3a8bfbd12598ef01fb9eb523a164d0"}, {file = "sphinx_collapse-0.1.2.tar.gz", hash = "sha256:a186000bf3fdac8ac0e8a99979f720ae790de15a5efc1435d4816f79a3d377c2"}, ] -sphinx-copybutton = [ - {file = "sphinx-copybutton-0.5.1.tar.gz", hash = "sha256:366251e28a6f6041514bfb5439425210418d6c750e98d3a695b73e56866a677a"}, - {file = "sphinx_copybutton-0.5.1-py3-none-any.whl", hash = "sha256:0842851b5955087a7ec7fc870b622cb168618ad408dee42692e9a5c97d071da8"}, -] +sphinx-copybutton = [] sphinx-multiversion-scylla = [ {file = "sphinx-multiversion-scylla-0.2.10.tar.gz", hash = "sha256:b54d664ecedcf45b98d6be1e939eac596719daa514e4a35f58d8e6330fb05d22"}, ] -sphinx-notfound-page = [ - {file = "sphinx-notfound-page-0.8.3.tar.gz", hash = "sha256:f728403280026b84c234540bebbed7f710b9ea582e7348a35a5becefe4024332"}, - {file = "sphinx_notfound_page-0.8.3-py2.py3-none-any.whl", hash = "sha256:c4867b345afccef72de71fb410c412540dfbb5c2de0dc06bde70b331b8f30469"}, -] +sphinx-notfound-page = [] sphinx-scylladb-theme = [ {file = "sphinx-scylladb-theme-1.2.1.tar.gz", hash = "sha256:55923651acb74988755fd818175999e953e018d372cb778dd5120b03f71fe5ab"}, {file = "sphinx_scylladb_theme-1.2.1-py3-none-any.whl", hash = "sha256:2666a6990c87c9601beb0c49f118e87d03b27c248ad263e553c3c9dbd9247ec9"}, @@ -936,49 +888,11 @@ tornado = [ {file = "tornado-6.2-cp37-abi3-win_amd64.whl", hash = "sha256:e5f923aa6a47e133d1cf87d60700889d7eae68988704e20c75fb2d65677a8e4b"}, {file = "tornado-6.2.tar.gz", hash = "sha256:9b630419bde84ec666bfd7ea0a4cb2a8a651c2d5cccdbdd1972a0c859dfc3c13"}, ] -typing-extensions = [ - {file = "typing_extensions-4.4.0-py3-none-any.whl", hash = "sha256:16fa4864408f655d35ec496218b85f79b3437c829e93320c7c9215ccfd92489e"}, - {file = "typing_extensions-4.4.0.tar.gz", hash = "sha256:1511434bb92bf8dd198c12b1cc812e800d4181cfcb867674e0f8279cc93087aa"}, -] -urllib3 = [ - {file = "urllib3-1.26.13-py2.py3-none-any.whl", hash = "sha256:47cc05d99aaa09c9e72ed5809b60e7ba354e64b59c9c173ac3018642d8bb41fc"}, - {file = "urllib3-1.26.13.tar.gz", hash = "sha256:c083dd0dce68dbfbe1129d5271cb90f9447dea7d52097c6e0126120c521ddea8"}, -] -watchdog = [ - {file = "watchdog-2.2.0-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:ed91c3ccfc23398e7aa9715abf679d5c163394b8cad994f34f156d57a7c163dc"}, - {file = "watchdog-2.2.0-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:76a2743402b794629a955d96ea2e240bd0e903aa26e02e93cd2d57b33900962b"}, - {file = "watchdog-2.2.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:920a4bda7daa47545c3201a3292e99300ba81ca26b7569575bd086c865889090"}, - {file = "watchdog-2.2.0-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:ceaa9268d81205876bedb1069f9feab3eccddd4b90d9a45d06a0df592a04cae9"}, - {file = "watchdog-2.2.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:1893d425ef4fb4f129ee8ef72226836619c2950dd0559bba022b0818c63a7b60"}, - {file = "watchdog-2.2.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:9e99c1713e4436d2563f5828c8910e5ff25abd6ce999e75f15c15d81d41980b6"}, - {file = "watchdog-2.2.0-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:a5bd9e8656d07cae89ac464ee4bcb6f1b9cecbedc3bf1334683bed3d5afd39ba"}, - {file = "watchdog-2.2.0-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:3a048865c828389cb06c0bebf8a883cec3ae58ad3e366bcc38c61d8455a3138f"}, - {file = "watchdog-2.2.0-cp38-cp38-macosx_10_9_universal2.whl", hash = "sha256:e722755d995035dd32177a9c633d158f2ec604f2a358b545bba5bed53ab25bca"}, - {file = "watchdog-2.2.0-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:af4b5c7ba60206759a1d99811b5938ca666ea9562a1052b410637bb96ff97512"}, - {file = "watchdog-2.2.0-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:619d63fa5be69f89ff3a93e165e602c08ed8da402ca42b99cd59a8ec115673e1"}, - {file = "watchdog-2.2.0-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:1f2b0665c57358ce9786f06f5475bc083fea9d81ecc0efa4733fd0c320940a37"}, - {file = "watchdog-2.2.0-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:441024df19253bb108d3a8a5de7a186003d68564084576fecf7333a441271ef7"}, - {file = "watchdog-2.2.0-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:1a410dd4d0adcc86b4c71d1317ba2ea2c92babaf5b83321e4bde2514525544d5"}, - {file = "watchdog-2.2.0-pp37-pypy37_pp73-macosx_10_9_x86_64.whl", hash = "sha256:28704c71afdb79c3f215c90231e41c52b056ea880b6be6cee035c6149d658ed1"}, - {file = "watchdog-2.2.0-pp38-pypy38_pp73-macosx_10_9_x86_64.whl", hash = "sha256:2ac0bd7c206bb6df78ef9e8ad27cc1346f2b41b1fef610395607319cdab89bc1"}, - {file = "watchdog-2.2.0-pp39-pypy39_pp73-macosx_10_9_x86_64.whl", hash = "sha256:27e49268735b3c27310883012ab3bd86ea0a96dcab90fe3feb682472e30c90f3"}, - {file = "watchdog-2.2.0-py3-none-manylinux2014_aarch64.whl", hash = "sha256:2af1a29fd14fc0a87fb6ed762d3e1ae5694dcde22372eebba50e9e5be47af03c"}, - {file = "watchdog-2.2.0-py3-none-manylinux2014_armv7l.whl", hash = "sha256:c7bd98813d34bfa9b464cf8122e7d4bec0a5a427399094d2c17dd5f70d59bc61"}, - {file = "watchdog-2.2.0-py3-none-manylinux2014_i686.whl", hash = "sha256:56fb3f40fc3deecf6e518303c7533f5e2a722e377b12507f6de891583f1b48aa"}, - {file = "watchdog-2.2.0-py3-none-manylinux2014_ppc64.whl", hash = "sha256:74535e955359d79d126885e642d3683616e6d9ab3aae0e7dcccd043bd5a3ff4f"}, - {file = "watchdog-2.2.0-py3-none-manylinux2014_ppc64le.whl", hash = "sha256:cf05e6ff677b9655c6e9511d02e9cc55e730c4e430b7a54af9c28912294605a4"}, - {file = "watchdog-2.2.0-py3-none-manylinux2014_s390x.whl", hash = "sha256:d6ae890798a3560688b441ef086bb66e87af6b400a92749a18b856a134fc0318"}, - {file = "watchdog-2.2.0-py3-none-manylinux2014_x86_64.whl", hash = "sha256:e5aed2a700a18c194c39c266900d41f3db0c1ebe6b8a0834b9995c835d2ca66e"}, - {file = "watchdog-2.2.0-py3-none-win32.whl", hash = "sha256:d0fb5f2b513556c2abb578c1066f5f467d729f2eb689bc2db0739daf81c6bb7e"}, - {file = "watchdog-2.2.0-py3-none-win_amd64.whl", hash = "sha256:1f8eca9d294a4f194ce9df0d97d19b5598f310950d3ac3dd6e8d25ae456d4c8a"}, - {file = "watchdog-2.2.0-py3-none-win_ia64.whl", hash = "sha256:ad0150536469fa4b693531e497ffe220d5b6cd76ad2eda474a5e641ee204bbb6"}, - {file = "watchdog-2.2.0.tar.gz", hash = "sha256:83cf8bc60d9c613b66a4c018051873d6273d9e45d040eed06d6a96241bd8ec01"}, -] +typing-extensions = [] +urllib3 = [] +watchdog = [] wcwidth = [ {file = "wcwidth-0.2.5-py2.py3-none-any.whl", hash = "sha256:beb4802a9cebb9144e99086eff703a642a13d6a0052920003a230f3294bbe784"}, {file = "wcwidth-0.2.5.tar.gz", hash = "sha256:c4d647b99872929fdb7bdcaa4fbe7f01413ed3d98077df798530e5b04f116c83"}, ] -zipp = [ - {file = "zipp-3.11.0-py3-none-any.whl", hash = "sha256:83a28fcb75844b5c0cdaf5aa4003c2d728c77e05f5aeabe8e95e56727005fbaa"}, - {file = "zipp-3.11.0.tar.gz", hash = "sha256:a7a22e05929290a67401440b39690ae6563279bced5f314609d9d03798f56766"}, -] +zipp = [] diff --git a/site/source/user-manual/connecting/connecting-lan/lan-os/lan-linux.rst b/site/source/user-manual/connecting/connecting-lan/lan-os/lan-linux.rst index ac1357c..f113438 100644 --- a/site/source/user-manual/connecting/connecting-lan/lan-os/lan-linux.rst +++ b/site/source/user-manual/connecting/connecting-lan/lan-os/lan-linux.rst @@ -3,21 +3,45 @@ ============================ Trusting Embassy CA on Linux ============================ - Nothing specific needs to be configured for the Linux environment at an OS level if you are only connecting over LAN through a **browser**. -However, if you want to connect over LAN using a **native app** (e.g. the Bitwarden app or ``git``) you will need to trust the Root CA. +.. _lan-linux-system: -Trusting Embassy CA on Ubuntu / Debian --------------------------------------- +Trusting Embassy CA System-Wide +------------------------------- +If you want to connect over LAN using a **native app** (e.g. Bitwarden, Nextcloud integrations, or ``git``) you will need to trust the Root CA for your distribution: -From the folder you have downloaded your Embassy’s Root CA, run the following commands: +.. tabs:: - .. code-block:: bash + .. group-tab:: Debian/Ubuntu - sudo apt-get install -y ca-certificates - sudo cp Embassy\ Local\ CA.crt /usr/local/share/ca-certificates - sudo update-ca-certificates + From the folder you have downloaded your Embassy's Root CA, run the following commands: + + .. code-block:: bash + + sudo apt-get install -y ca-certificates + sudo cp Embassy\ Local\ CA.crt /usr/local/share/ca-certificates + sudo update-ca-certificates -In the output it should say ``1 added`` if it was successful. \ No newline at end of file + In the output it should say ``1 added`` if it was successful. + + .. group-tab:: Arch/Garuda + + From the folder you have downloaded your Embassy's Root CA, run the following commands (if you have changed the certificate's filename, be sure to change it here): + + .. code-block:: bash + + sudo pacman -S ca-certificates + sudo cp Embassy\ Local\ CA.crt /etc/ca-certificates/trust-source/anchors + sudo update-ca-trust + + There will be no output to verify success; you can test your app right away. + + .. group-tab:: CentOS/Redhat + + .. code-block:: bash + + sudo yum install ca-certificates + sudo cp Embassy\ Local\ CA.crt /etc/pki/ca-trust/source/anchors + sudo update-ca-trust \ No newline at end of file diff --git a/site/source/user-manual/service-guides/index.rst b/site/source/user-manual/service-guides/index.rst index da1d0fb..c03dbc0 100644 --- a/site/source/user-manual/service-guides/index.rst +++ b/site/source/user-manual/service-guides/index.rst @@ -4,7 +4,7 @@ Service Guides ============== -These guides will help you to setup external tools to connect or interact with specific :ref:`Services`, such as a chat client or :ref:`Bitcoin` wallet. +These guides will help you to setup external tools to connect or interact with specific :ref:`Services`. .. toctree:: :maxdepth: 2 @@ -12,4 +12,5 @@ These guides will help you to setup external tools to connect or interact with s bitcoin/index lightning matrix + nextcloud/index vaultwarden diff --git a/site/source/user-manual/service-guides/nextcloud/index.rst b/site/source/user-manual/service-guides/nextcloud/index.rst new file mode 100644 index 0000000..e819b99 --- /dev/null +++ b/site/source/user-manual/service-guides/nextcloud/index.rst @@ -0,0 +1,16 @@ +.. _nextcloud-service: + +========= +Nextcloud +========= + +These guides will help you to setup tools to connect or interact with Nextcloud on your Embassy by device. + +.. toctree:: + :maxdepth: 1 + + nextcloud-linux + nextcloud-mac + nextcloud-windows + nextcloud-android + nextcloud-ios \ No newline at end of file diff --git a/site/source/user-manual/service-guides/nextcloud/nextcloud-android.rst b/site/source/user-manual/service-guides/nextcloud/nextcloud-android.rst new file mode 100644 index 0000000..81e6dcb --- /dev/null +++ b/site/source/user-manual/service-guides/nextcloud/nextcloud-android.rst @@ -0,0 +1,80 @@ +.. _nextcloud-android: + +=================== +Nextcloud - Android +=================== + +.. 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. + +Nextcloud App +------------- +The latest version of the official Nextcloud client is available on their `download page `_. This is for file syncing and account management. + +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. + +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 `_. 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 `_ 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 LAN address from "Interfaces" on your Nextcloud service page and add `/remote.php/dav` after `.local` + + - 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 `_ app, which allows subscription to remote WebCa or local iCal files (such as public event schedules, iCloud/Google calendars, etc). It can be found in your favorite app store. \ No newline at end of file diff --git a/site/source/user-manual/service-guides/nextcloud/nextcloud-ios.rst b/site/source/user-manual/service-guides/nextcloud/nextcloud-ios.rst new file mode 100644 index 0000000..7470846 --- /dev/null +++ b/site/source/user-manual/service-guides/nextcloud/nextcloud-ios.rst @@ -0,0 +1,76 @@ +.. _nextcloud-ios: + +=============== +Nextcloud - iOS +=============== + +.. 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. + +Standalone Client +----------------- +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. + +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 `_. 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. Open the "Settings" app. + + .. 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" (return to this step after completing one in order to add the other). + +3. Select either CalDAV (for Calendar setup) or CardDAV (for Contacts setup), and enter the following fields: + + - Server - Enter your Nextcloud server LAN URL (found in "Interfaces" in the Nextcloud service page on your Embassy), and add `/remote.php/dav` after `.local` + + - User name - Your Nextcloud user (Default is "embassy") + + - Password - Your Nextcloud user's password (Default found in "Properties" in the Nextcloud service page on your Embassy) + + - Description - Anything to describe this account, such as "Nextcloud CalDAV" + +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) \ No newline at end of file diff --git a/site/source/user-manual/service-guides/nextcloud/nextcloud-linux.rst b/site/source/user-manual/service-guides/nextcloud/nextcloud-linux.rst new file mode 100644 index 0000000..977380b --- /dev/null +++ b/site/source/user-manual/service-guides/nextcloud/nextcloud-linux.rst @@ -0,0 +1,89 @@ +.. _nextcloud-linux: + +================= +Nextcloud - Linux +================= + +.. 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. + +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 Embassy Root CA to your system`. + +The following desktop environments support integrated account syncing, including Nextcloud: + + - Gnome (Ubuntu default) + - Cinnamon (Linux Mint default) + - KDE + - Budgie + +Check out this `Linuxhint guide `_ and our `Nextcloud Master Thread `_ for assistance. 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. + +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 `. or you can get the latest version as an AppImage from the `Download for Desktop `_ section of Nextcloud's website. + +LAN Setup +......... +Make sure you have first set up :ref:`LAN access`. + +1. Open the client and click "Log In" +2. From your Embassy'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 Embassy'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 + +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. \ No newline at end of file diff --git a/site/source/user-manual/service-guides/nextcloud/nextcloud-mac.rst b/site/source/user-manual/service-guides/nextcloud/nextcloud-mac.rst new file mode 100644 index 0000000..8ffcf5b --- /dev/null +++ b/site/source/user-manual/service-guides/nextcloud/nextcloud-mac.rst @@ -0,0 +1,99 @@ +.. _nextcloud-mac: + +================= +Nextcloud - MacOS +================= + +.. 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 +-------------------------- +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. The steps below are adapted from the `Official Nextcloud guide `_ and updated for the latest MacOS (Ventura). Make sure you have first set up :ref:`LAN access`. + +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 "embassy," 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 +------------------ +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 `_. + +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 -> Enable Tor. +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. +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. + +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. \ No newline at end of file diff --git a/site/source/user-manual/service-guides/nextcloud/nextcloud-windows.rst b/site/source/user-manual/service-guides/nextcloud/nextcloud-windows.rst new file mode 100644 index 0000000..befb91d --- /dev/null +++ b/site/source/user-manual/service-guides/nextcloud/nextcloud-windows.rst @@ -0,0 +1,95 @@ +.. _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. \ No newline at end of file diff --git a/site/source/user-manual/service-guides/vaultwarden.rst b/site/source/user-manual/service-guides/vaultwarden.rst index 3bdf222..1490701 100644 --- a/site/source/user-manual/service-guides/vaultwarden.rst +++ b/site/source/user-manual/service-guides/vaultwarden.rst @@ -8,7 +8,9 @@ Vaultwarden :depth: 2 :local: -.. note:: The version of Bitwarden server used on the Embassy is a fork called "Vaultwarden." Despite this, it still functions with several of the apps/integrations that are built for, and still named after, "Bitwarden." We apologize for any confusion this may cause. +Vaultwarden is a self-hosted password manager, which means your passwords physically live on your Embassy. Be sure to create backups and keep them safe! If you lose your Embassy or uninstall Vaultwarden, and you have not made a backup, all your passwords will be lost forever. If you currently have a *hosted* account with Bitwarden, you can export your data from that account and import it to your Vaultwarden service on Embassy using the built-in import/export features in any Bitwarden application. + +.. note:: The version of Bitwarden server used on the Embassy is a fork called "Vaultwarden." It functions with all of the apps/integrations that are built for, and still named after, "Bitwarden." We apologize for any confusion this may cause. Check out our `Vaultwarden video `_ for basic features and setup! @@ -17,7 +19,6 @@ Check out our `Vaultwarden video `_ Web Vault --------- - 1. First we will open up our Embassy and go to the Marketplace tab, select Vaultwarden, and install if you have not already done so. 2. After install, click Configure. A strong admin token has been securely created by your Embassy, but you may change it if you wish. This can also be changed later. Click save. Click start to run the service. @@ -30,9 +31,12 @@ Web Vault 5. Back at the main page for your vault, let's do a quick example login. We can setup a new folder here and save new login. For our example, we're going to use our FileBrowser instance. So click 'Add item,' then we'll fill in some test information. A name for the entry, a username, password, and the website we want to log in to. Then click 'Save.' +Accessing the Admin Console +=========================== +You will find the Admin console by adding `/admin` to the end of your Vaultwarden WebUI URL, found in the "Interfaces" section of the Vaultwarden Service page. You will be prompted for your "Admin Token," which is also found on your Vaultwarden Service page under "Properties." + Browser Extension ----------------- - The Bitwarden browser extension will only work with Tor browser or Firefox, since those are the only two browsers capable of using Tor, or in other words, access .onion URLs. Brave Browser can also access .onion URLs, but only in special tabs, not in extension, so the Bitwarden extension will not work on Brave. 1. If you choose Tor Browser, everything will just work right out of the box. If you choose Firefox, you will need to configure both your :ref:`device ` and :ref:`Firefox ` to use Tor. @@ -97,9 +101,7 @@ Mac #. For LAN access, follow the LAN setup in the instructions below. After completing setup, simply open Bitwarden and add your Vaultwarden LAN address in the 'Settings' and login. #. Tor - #. First, be sure to :ref:`Setup Tor ` natively. - - #. Run the program with the flag ``--proxy-server=socks5://127.0.0.1:9050`` behind it. You can run this from a terminal, and if you'd like to use a shortcut, edit that shortcut file to include the flag. + Set up the system-wide proxy on your system with our :ref:`Tor guide`. #. You can now log in to your vault.