- Note: We are still testing some features of Nextcloud, so please bear with us through any technical hiccups
- 1 Accounts
- 2 How to Use Nextcloud
- 3 Our Common Space
- 4 FAQ
- 5 QA
- 6 The Software
- 7 People and Moderation
- 8 Proposed Improvements
- 9 Technical Details
To get an account on our public Nextcloud instance, please email email@example.com.
WARNING! Please familiarize yourself with Nextcloud before you start using it, to make sure that you don't delete data (Your own or someone else's...)
How to Use Nextcloud
- WebDAV URLs:
You can even access files via LibreOffice directly.
- One of the most convenient ways to work with Nextcloud is to access the server via WebDAV.
- Once mounted as a WebDAV share, you can upload and download files and folders by drag-and-drop.
- URL: https://nextcloud.documentfoundation.org/
- The Nextcloud web interface gives you more features than the WebDAV interface.
- Ability to change your password and other settings
- Set and change permissions/sharing on files and folders in your Files.
Our Common Space
One of our primary workflows for Nextcloud is to store content in a shared directory named Common editable by all accounts in the group users and visible (read-only) to anyone via a separate url.
Accessing the Common space
After you log in to Nextcloud, you should see a directory Shared in the top level of your files. This directory will contain any content that has been shared with you by other users of our Nextcloud instance, including a directory named Common.
Quick Version: * Log in * Click Shared -> Common
Inside the Common folder you will see a number of subfolders including
- zz - Playground for Testing Nextcloud
These directories roughly line up with Teams in LibreOffice or TDF. It's good practice to organize content hierarchically under this directory structure so that if someone is looking for QA's proposal for migrating to our own Bugzilla, you could find that content under Common/QA/Proposals.
All content should be under a subdirectory -- there should be no files shared directly underneath Common.
To share a read-only link to a file or folder inside Common with someone who doesn't have a TDF Nextcloud account, just shorten the URL as described below...
Here's the private URL you'll see via WebDAV:
Or in your web browser:
...and here's the public URL:
Notes about Common
- We use mod_rewrite magic to make this work
- It only works with the shared Common folder
- Public urls for the Common folder provide read-only access.
- Given a public URL for any item in the Common folder, a user may browse the entire contents of the Common folder.
As you might have guessed, "zz - Playground for Testing Nextcloud" is a sandbox in which you may play around with Nextcloud. If you upload 100MB or more of test files, please delete them when you're done testing.
If you would like to do more in-depth testing of Nextcloud, or have a new project that might require some further tweaking of the software, please let us know and we can work to set you up with a separate instance for testing.
Have some questions? Please let us know!
Q: Why can't I log in?
- A: Do you have an Nextcloud account? Have you double-checked your password?
- Please check with one of the admins if you're still stuck.
Q: Why can't I upload to the Common folder?
- A: Please check to make sure
- You're logged-in
- You're accessing the Common folder via your account
Q: How big a file may I upload?
- A: If you need to upload any single file or set of files larger than 150MB, please ping the admins ahead of time, so we can make sure there's enough free space allocated.
- A: Sorry, you're in the wrong place.
Large Files for QA
Once we have our own instance of Bugzilla we will increase the file size limit to at least 10MB.
Sensitive Files for QA
Sometimes we are given sensitive/private files for QA. Our first goal is to sanitize any sensitive files of private/confidential information or to create substitute files that reproduce the faulty behavior of the original files. If this is not possible or is considered too difficult, we may accept the file for private storage in the shared folder QA-Private.
- The shared folder QA-Private is only accessible by a small number of devs and QA Team members.
- Files in QA-Private are stored in a folder hierarchy based on bug and bug #:
- After uploading a new file, a comment should be added to the corresponding bug report that said file exists.
- If you download content from this folder, please remember to delete your local copy of the file(s) after your work is complete.
Nextcloud is written largely in PHP and licensed under the AGPL. For more info:
People and Moderation
If you have any questions, please feel free to contact the infra team: Category:Infrastructure
nothing so far...
The way that we implement the Common directory is to have a dedicated user libreoffice that owns this directory and shares it with all accounts in the users group (the users group was also created by us).
The libreoffice user also uses the "Share with link" feature to share the contents of this directory, and we set up a custom mod_rewrite link so that https://nextcloud.documentfoundation.org/common/PATH/TO/CONTENT will work. Please note that any changes in ownership or permissions on this directory may mean that the Nextcloud url will change, which will require us updating the mod_rewrite rule on the server.
As of April 2014, here's the public url:
Here's how the redirects work in nextcloud/.htaccess (right after the 'RewriteEngine On' line):
RewriteRule ^[Cc]ommon(.*)$ public.php?service=files&t=<magic hash # goes here>&path=/$1 [L]
If desired, we may set up additional shared directories owned by the libreoffice user.
Space constraints: The libreoffice user currently has 5GB of storage allocated. Because Nextcloud does some internal versioning and users may upload large documents, we may want to increase this size allocation as soon as we've used half of the available storage space.