[[PageOutline]] = How Can I Share, Calendars and Contacts documents? = MF/PL members have access to our shared Nextcloud server at https://share.mayfirst.org/. Through share.mayfirst.org, you can: * Share files with your co-workers or friends via a folder on your computer or android or iphone. Easy to use! Just copy the file to the folder and it is automatically shared with everyone who you have provided access to that folder. * Collaboratively edit files using a web browser - word processing documents, spread sheet and even presentations - that are automatically saved as LibreOffice documents. * Store up to 5GB (ask us for more space if you need it) * Synchronize/backup your phone contacts and calendar to a trusted server (no need to send your contact list to Google) == How do I get started? == Anyone with a user account with May First/People Link can login immediately to Nextcloud. That means, if you already have a username and password that you use to login to your May First/People Link email account, or that you use to secure FTP into your web site, you can use the same username/password pair to login to Nextcloud. You can add new "User Accounts" in the [https://members.mayfirst.org/cp Members Control Panel] - and they will automatically be able to access Nextcloud too. == How do I access Nextcloud via a web browser? You can get started right away by going to https://share.mayfirst.org/ and entering your MF/PL username (you can use any valid username - your email login, SFTP login, control panel login, etc). === Sharing with other users === You can share a folder or file with other users by cicking on the share icon next to the file or folder. You can either type a username of a user that has already logged into our Nextcloud program, or you can click the checkbox to generate a random web address that anyone can use to access a file. Be sure to carefully choose the permissions you want to grant. You can also share a calendar. Click on the '''share calendar''' icon , this is the first icon to the right of your calendar's name. [[Image(owncloud_share_calendar1.png)]] Type the full username of the user you want to share with. Matching names will appear in a list below the field. MFPL users must have logged in to http://share.mayfirst.org at least once before they will appear in the list. Click on the name in the list that matches. [[Image(owncloud_share_calendar2.png)]] You can edit additional options allowing or restricting that user's ability to share this calendar with others, edit the calendar as well as create, delete or update calendar items. [[Image(owncloud_share_calendar3.png)]] Repeat this process for each user with whom you would like to share this calendar. The new calendar will appear within their account. ''See below for how to share with groups of people.'' == How do I synchronize with my desktop computer? == === Synchronizing files === First, download the Nextcloud program for your operating system: https://nextcloud.com/install/#install-clients NOTE: Mac OS users, there seems to be a bug in the latest Nextcloud client - please use the compatible [https://owncloud.org/install/#install-clients owncloud client] instead until this [https://help.nextcloud.com/t/mac-sync-client-does-not-conncet-to-nc-12/12889/6 issue is resolved]. You will be prompted to pick a folder on your own computer to store your files. Then, you will be prompted to enter the server address for your Nextcloud installation, which is: https://share.mayfirst.org/ Then you will need to enter your username and password. That's it! === Synchronizing your calendar === The most well-tested application for syncing with your Calendar is the [http://www.mozilla.org/projects/calendar/lightning/ Lightning extension] to the [http://www.mozilla.com/thunderbird/ Mozilla Thunderbird] email client. Using Lightning: * Choose to subscribe to a remote calendar. Click on File -> New -> Calendar. * Choose "On the network" for the calendar location * Choose "CalDav" as the format * For location, you can lookup it up by: * logging into Nextcloud via the web site (https://share.mayfirst.org/) * click on the calendar icon * on the left side, you will see a list of your calendars. Next to each calendar is the "..." symbol to indicate additional options. Click that symbol and select "Link", then copy and paste what is displayed * it should look something like the following, with "USERNAME" replaced by your actual username and CALENDARNAME replaced with the actual name of your calendar: https://share.mayfirst.org/remote.php/caldav/calendars/USERNAME/CALENDARNAME In addition, you can download your calendar in ical (ics) format by using the following URL: {{{ https://USERNAME:PASSWORD@share.mayfirst.org/remote.php/caldav/calendars/USERNAME/CALENDARNAME?export }}} === Synchronize your contacts === For Thunderbird, you can synchronize your contacts using the Cardbook Thunderbird extension. There is an [https://docs.nextcloud.com/server/12/user_manual/pim/sync_thunderbird.html excellent tutorial on setting that up on the Nextcloud site]. == How do I synchronize with my mobile phone? == === Synchronizing Files === You can download either the [https://play.google.com/store/apps/details?id=com.nextcloud.client android app] or the [https://itunes.apple.com/us/app/nextcloud/id1125420102?mt=8 iPhone app]. You'll be asked the same questions as the ones above. === What about synchronizing my contacts and calendar? === On Android, install the DavDroid app (it seems to be available in both Google Play and f-droid). You'll need to create separate sync accounts for your contacts and your calendar. When entering the server address, use: * Calendar: https://share.mayfirst.org/remote.php/caldav/ * Conctacts: https://share.mayfirst.org/remote.php/carddav/ == How do I synchronize with my web site? == May First/People Link's servers have the owncloudcmd program installed which allows you to synchronize files on our servers to your Nextcloud account. * First, create a file in your user's home directory called `.netrc` * Make sure it is only readable by you: {{{ chmod 600 ~/.netrc }}} * Add the following information to the file, replace and with your actual username and password. {{{ machine share.mayfirst.org login password }}} * Create a scheduled job in the control panel with the following command: {{{ owncloudcmd --silent -n $HOME/ownCloud https://share.mayfirst.org/remote.php/webdav > /dev/null }}} == Can I create groups of people to share with? == Yes you can! You can use our next feature called "circles." === First, create user accounts for all of your users. === * Login to the [https://members.mayfirst.org/cp Members Control Panel] and create a user account for each person you will be sharing with. * You can send them a password reset email (click "Password Reset") in the left hand side bar. * Be sure everyone logs into at https://share.mayfirst.org/. You cannot share a folder or calendar with someone who has not yet logged in. === Now organize your shares === * You can take the following steps as any user in your organization. However, ''we recommend creating a special user in the control panel (e.g. yourorg-nextcloud-admin).'' That way, if you leave the organization, there can be an easy and smooth transition to maintaing your shares and you don't have to worry about shares being deleted if you delete their account. * Login to Nextcloud and click the Circles application (the circle with three dots around it). * Create a new circle by filling in a name * Select the circle type. We recommend creating a "personal" circle. If you choose a closed circle, the people you add will need to confirm membership before they are added to the circle. '''If you choose secret circle, your circle will be hidden, but if someone knows the name, then they can add themselves without admin approval. For this reason we recommend against using secret circles.''' * Now create the folders and calendars you want to share. You can assign one or more circles to each share. * Any user can create folders and calendars and share them with your circles - however, if that user is ever removed from the control panel, then your shares will go with them. So, creating a dedicated user is a good idea. === General maintenance === * Everytime a new user comes or goes, log in as the special user and add or remove them to the appropriate circles.