Getting Started

Installation

Docker

Make sure to have Docker, Docker-Compose, Node.js and Yarn installed.

This setup currently doesn’t work on Windows out of the box.

Workaround One of our contributors has opened a PR to a dependency that prevents us from successfully bundling the frontend. Feel free to check out [his changes](https://github.com/egoist/rollup-plugin-postcss/pull/384) and build them locally if you absolutely want to work on Windows.

After cloning the source code, install the dependencies via yarn install and bundle the frontend code by running yarn build:w.

Then, you can start the backends by running docker-compose up oc10 ocis and access them via https://host.docker.internal:9200 (oCIS) and http://host.docker.internal:8080 (OC10). If you’re not using Docker Desktop, you might have to modify your /etc/hosts and add 172.17.0.1 docker.host.internal to make the host.docker.internal links work.

The bundled frontend code automatically gets mounted into the Docker containers, recompiles on changes and you can log in using the demo user (admin/admin) and take a look around!

Source code

The source code is hosted at https://github.com/owncloud/web. Please refer to the build documentation for Web.

Configuration

Depending on the backend you are using, there are sample config files provided in the config folder of the ownCloud Web git repository. See below for available backends. Also, find some of the configuration details below.

Options

  • options.hideSearchBar Lets you hide the search bar at the top of the screen for all users.
  • options.homeFolder You can specify a folder that is used when the user navigates home. Navigating home gets triggered by clicking on the All files menu item. The user will not be jailed in that directory. It simply serves as a default location. You can either provide a static location, or you can use variables of the user object to come up with a user specific home path. This uses twig template variable style and allows you to pick a value or a substring of a value of the authenticated user. Examples are /Shares, /{{.Id}} and /{{substr 0 3 .Id}}/{{.Id}.
  • options.disablePreviews Set this option to true to disable previews in all the different file listing views. The only list view that is not affected by this is the trash bin, as that doesn’t allow showing previews at all.
  • options.previewFileExtensions Specifies which filetypes will be previewed in the ui. For example to only preview jpg and txt files set this option to ["jpg", "txt"].
  • options.disableFeedbackLink Set this option to true to disable the feedback link in the topbar. Keeping it enabled (value false or absence of the option) allows ownCloud to get feedback from your user base through a dedicated survey website.
  • options.sharingRecipientsPerPage Sets the amount of users shown as recipients in the dropdown when sharing resources. Default amount is 200.

Setting up backend and running

Web can run against either ownCloud 10 as backend or oCIS. Depending which one you chose, please check the matching section:

Running