This is a guide on how you can run both Reva and wopiserver locally in a dev environment. The wopiserver will allow you to connect Reva to online editors such as collabora.
If you encounter strange problems, please check which version of the prerequisites you are running, it might be that you need to update/downgrade. For reference ask someone who already has reva and Phoenix running, they will have updated information on the versions. * golang >= 1.12 * make/automake * git >= 2 * python >=3.7
Clone the wopiserver repo from https://github.com/cs3org/wopiserver
git clone https://github.com/cs3org/wopiserver
Clone the reva repo from https://github.com/cs3org/reva
git clone https://github.com/cs3org/reva
disable_tus = true under
[http.services.dataprovider] and under
[grpc.services.storageprovider] in the file
Follow the instructions in https://reva.link/docs/getting-started/install-reva/ for how to build reva. If you will do local changes in reva, follow the “Build from sources” instructions.
Now you need to run Revad (the Reva daemon). Follow these steps from the reva folder:
cd examples/ocm/ && ../../cmd/revad/revad -c ocmd-server-1.toml & ../../cmd/revad/revad -c ocmd-server-2.toml &.
The Reva daemon (revad) should now be running.
Follow the instructions in the readme for running the server locally (“Run the WOPI server locally”, https://github.com/cs3org/wopiserver). You will need to do come changes in the config file, here is a more relevant example of a wopi config when runnning the server together with reva:
# # wopiserver.conf - basic working configuration for a docker image # [general] storagetype = cs3 port = 8880 allowedclients = localhost oosurl = https://oos.web.cern.ch codeurl = https://collabora.cern.ch:9980/byoa/collabora codimdurl = http://cbox-wopidev-01.cern.ch:8000 tokenvalidity = 86400 wopiurl = localhost:8880 downloadurl = localhost:8880/wopi/cbox/download # Logging level. Debug enables the Flask debug mode as well. # Valid values are: Debug, Info, Warning, Error. loglevel = Debug [security] usehttps = no # location of the secret files. Requires a restart of the # WOPI server when either the files or their content change. wopisecretfile = /etc/wopi/wopisecret iopsecretfile = /etc/wopi/iopsecret [cs3] revahost = localhost:19000 authtokenvalidity = 3600 [io] # Size used for buffered xroot reads [bytes] chunksize = 4194304
Run according to instructions in the readme (“Run the WOPI server locally”, https://github.com/cs3org/wopiserver).
To try the connection you could for example go to a new reva terminal window and type
./cmd/reva/reva -insecure login basic - use einstein and relativity as log in ccredentials
./cmd/reva/reva -insecure open-file-in-app-provider /home/example.txt read - this should print out the app provider url in your terminal.