@coboxcoop/seeder

a JSON API for seeder, the always online peer/node

Usage no npm install needed!

<script type="module">
  import coboxcoopSeeder from 'https://cdn.skypack.dev/@coboxcoop/seeder';
</script>

README

seeder

Table of Contents

About

CoBox is an encrypted p2p file system and distributed back-up tool. README provides a map of the project.

seeder provides an 'always on' blind replicator seeder designed to be hosted in your office or home. It exposes an ExpressJS HTTP JSON API, pairing with CoBox Server and a Yargs CLI enabling issuing remote commands from a registered and authenticated CoBox Server instance over the Hyperswarm DHT using the Hypercore Protocol.

Installing and Updating

Install and Update Script

To install or update cobox-server, you should run the install script. To do that, you may either download and run the script manually, or use the following cURL or Wget command:

curl -o- https://cobox.cloud/releases/cobox-seeder_v1.0.0-alpha.1/download.sh | bash
wget -qO- https://cobox.cloud/releases/cobox-seeder_v1.0.0-alpha.1/download.sh | bash

Running either of the above commands downloads a script and runs it. The script downloads a tarball that contains the release binary required by your operating system with additional assets and unpacks the contents to the install directory.

Troubleshooting on Linux

On Linux, after running the install script, if you get cobox-seeder: command not found or see no feedback from your terminal after you type command -v cobox-seeder, simply close your current terminal, open a new terminal, and try verifying again.

Verify Installation

To verify that CoBox has been installed correctly, do:

command -v cobox-seeder

NPM Install

npm install -g @coboxcoop/seeder

cobox-seeder

Git Install

Before you get started, ensure you have git and node installed. We currently release using v12.16.3 which we recommend using. You can download and install nodejs from your distribution package manager, or direct from their website.

# clone the repository
git clone http://gitlab.com/coboxcoop/server && cd server

npm install -g yarn

# install dependencies
yarn

# start the app
yarn start

# use the cli
node bin

Usage

CoBox Seeder can be administrated in two ways.

  1. Directly on the seeder that is running it using the CLI
  2. By sending commands across the hypercore-protocol from an authenticated CoBox Server instance

CLI

CoBox Hub 1.0 - a tool for distributed and mutual backup infrastructure

  Copyright (C) 2019 Magma Collective T&DT, License GNU AGPL v3+
  This is free software: you are free to change and redistribute it
  For the latest sourcecode go to <https://code.cobox.cloud/>

Usage: bin <command> [options]

Commands:
  bin backups <command>    back-up your peers' spaces
  bin broadcast <command>  announce authentication details over the local area
                           network
  bin keys <command>       manage your hub's keys
  bin down [options]       stop the seeder app
  bin up [options]         start the seeder app

Options:
  -h, --help, --help        Show help                                  [boolean]
  -v, --version, --version  Show version number                        [boolean]

For more information on cobox read the manual: man cobox-hub
Please report bugs on <http://gitlab.com/coboxcoop/core/issues>.

Commands

When first initialised, CoBox Seeder begins broadcasting UDP packets announcing its authentication keys. You can use CoBox Server to retrieve these keys over the LAN, either with the cobox seeders pair CLI command or through the admin dashboard in the UI. With these keys you can send commands to the Seeder app and request it to perform backups. See the CoBox CLI for more details.

Contributing

PRs accepted.

Small note: If editing the README, please conform to the standard-readme specification.

License

AGPL-3.0-or-later