Go to file
retrevor a2fa7fbf5f
Issue 45 Upgrade swarm plugin to versions NC 26,27 (#46)
* Added versioning for nc 27
Modified permisions for sharing
Removed parent function for compatiblity

* Added core functionality to abstract methods.

* Minor corrections and optimizations

* Removed getDirectoryContent

* Return mtime and size in stat() function to allow shared files to be downloaded

* Changelog updated

---------

Co-authored-by: Take one <rontrevor@hotmail.com>
2024-03-28 15:29:16 +01:00
.github Fix release workflow 2022-09-29 01:38:07 +02:00
.vscode 23 name change (#24) 2022-04-25 13:52:04 +02:00
appinfo Issue 45 Upgrade swarm plugin to versions NC 26,27 (#46) 2024-03-28 15:29:16 +01:00
assets/images 25 right click options on files stored in swarm to copy hash (#37) 2023-03-01 13:01:58 +01:00
css Prep for release (#32) 2022-09-29 01:25:15 +02:00
docker/nextcloud Beta version of proxy request to buy new Postage Stamps (#40) 2023-10-06 14:51:54 +02:00
img Basic UI settings to configure swarm node. (#15) 2022-03-30 21:06:26 +02:00
js 43 board105 card3248 folder actions (#44) 2024-02-15 15:05:32 +01:00
lib Issue 45 Upgrade swarm plugin to versions NC 26,27 (#46) 2024-03-28 15:29:16 +01:00
src 39 proxy request from bee node setting (#42) 2023-10-27 12:00:02 +02:00
templates Remove rogue php tag (#38) 2023-03-23 12:56:42 +01:00
.editorconfig Improve debug setup 2022-02-04 12:43:42 +01:00
.eslintrc.js Prep for release (#32) 2022-09-29 01:25:15 +02:00
.gitignore Vue app for setting page (#21) 2022-09-19 19:16:26 +02:00
.php-cs-fixer.dist.php Prep for release (#32) 2022-09-29 01:25:15 +02:00
.prettierignore Prep for release (#32) 2022-09-29 01:25:15 +02:00
.prettierrc.json Add devtools (#18) 2022-04-04 12:13:18 +02:00
CHANGELOG.md Issue 45 Upgrade swarm plugin to versions NC 26,27 (#46) 2024-03-28 15:29:16 +01:00
LICENSE Initial commit 2021-09-25 17:09:27 +01:00
Makefile Prep for release (#32) 2022-09-29 01:25:15 +02:00
README.md 25 right click options on files stored in swarm to copy hash (#37) 2023-03-01 13:01:58 +01:00
babel.config.js Add devtools (#18) 2022-04-04 12:13:18 +02:00
composer.json 23 name change (#24) 2022-04-25 13:52:04 +02:00
composer.lock Add devtools (#18) 2022-04-04 12:13:18 +02:00
docker-compose.yaml 23 name change (#24) 2022-04-25 13:52:04 +02:00
package-lock.json Update package-lock 2022-09-29 01:33:12 +02:00
package.json Prep for release (#32) 2022-09-29 01:25:15 +02:00
stylelint.config.js Prep for release (#32) 2022-09-29 01:25:15 +02:00
webpack.config.js Prep for release (#32) 2022-09-29 01:25:15 +02:00

README.md

Nextcloud Swarm Plugin

Decentralized Sovereign cloud-storage comes to Nextcloud!

This plugin brings Swarm to Nextcloud - decentralized file-storage, connected to the blockchain.

View file and action menu

File view when using the plugin in Nextcloud

Table of Contents

Dependencies

To use the plugin you need the following

  • A Nextcloud instance
  • A Bee node

Setup and Installation

For setting up a Bee node please have a look at the official documentation

The following steps explain how to configure a Bee node in Nextcloud.

  • Make sure the "External Storage" plugin is enabled
  • Install the "External Storage: Swarm" app from the Nextcloud App store
  • Navigate to External Storage Administration (Profile menu -> Settings -> External Storage)
  • Add the connection settings for a new Bee node
  • Navigate to Ethswarm Storage Administration (Profile menu -> Settings -> Ethswarm Storage)
  • Configure the Bee node - by default, encryption is active
  • To use a Bee node, it is necessary to Purchase a Batch of new stamps from the funds in the node's wallet account
  • Once the new batch is purchased, a unique batchId is generated. Once your batch has been purchased, it will take a few minutes for other Bee nodes in the Swarm to catch up and register your batch. Allow some time for your batch to propagate in the network before proceeding to the next step. This is indicated by the checkbox "Usable".
  • Uploading files to the swarm costs Bzz, so it is necessary to select a Batch as "Active". Only 1 batch is allowed to be Active for a given Bee node. Then click "Save Settings".

Usage

File handling operations involving the Bee node are integrated in the External Storage ("Files") section of Nextcloud.

View file and action menu

View, download, and file view actions in Nextcloud

Using the plugin, the main file operations that are available in Nextcloud are:

  • Upload file(s) to a Bee node
  • Download and view files
  • Copy/Move files from any External Storage to a Bee node
  • Copy files from a Bee node to any External Storage
  • View and copy the unique swarm reference to the clipboard for any file stored on a Bee node

Settings

Available to users with administrative credentials, the external storage accepts configuration options from two places, the normal External Storage settings, which allows a user to configure the basic connection properties of a Bee node:

Setup Swarm External Storage

Basic Swarm setup in External Storage in Nextcloud administration

Since every operation in Swarm costs money, it is important to view how much money is available to the Bee node directly and also provide a convenient way of handling the payment system in Swarm - all managed directly in Nextcloud. This is in a specific section with more advanced configuration for the Bee node, where the following settings can be viewed and edited:

  • Configure which Bee node to manage
  • View current status of the Bee node
  • Option to toggle encryption on and off
  • How much BZZ is available to the node
  • Any purchased stamp batches and the remaining balances
  • Have the option to purchase a new batch of stamps
  • Toggle the batch used for uploading files active/inactive

Setup Swarm External Storage

Advanced configuration of Swarm in Nextcloud administration

Using Swarm

Once setup and configured, the Bee node is ready to use.

  • Navigate to "Files" option on the menu -> "External Storage" and then the name of the Bee node.
  • Click to Upload file(s):

Upload file

Upload file to swarm in Nextcloud

  • Once uploaded, it can be viewed internally or downloaded. It can also be copied to another storage.

View file and action menu

View, download, and file view actions in Nextcloud

  • Files from another Nextcloud storage can also be copied/moved to the Bee node. Choose the Bee node as the target Folder

Copy file

  • Right-click on a swarm file to copy the swarm reference (or hash) to the clipboard. Alternatively click the 3 dots of the Actions menu and select the menu option "Copy swarm reference". The swarm reference is the unique address of the file on the swarm.

Copy swarm reference to clipboard

Copy swarm reference to clipboard

License

This program is licensed under the AGPLv3 or later.