Commit 2b3708ff390cc334653a3a9ff0f511f866423af7
Merge pull request #14 from hamnox/patch-1
edits for migration of sbot to ssb-serverChristian Bundy authored on 11/19/2019, 8:24:36 PM
GitHub committed on 11/19/2019, 8:24:36 PM
Parent: 73683cb570cf00ded6a569f3b48e6b0eb4ccc69c
Parent: aa9b649037f4e54ee19dc3d605650538f2bdbef7
Files changed
| tmpl/apis/modules/secret-stack.md | ||
|---|---|---|
| @@ -4,9 +4,9 @@ | ||
| 4 | 4 … | |
| 5 | 5 … | SecretStack is built on [secret-handshake](https://github.com/dominictarr/secret-handshake) |
| 6 | 6 … | and [muxrpc](https://github.com/ssbc/muxrpc). This provides a framework |
| 7 | 7 … | to make building secure, decentralized systems easier. |
| 8 | -(such as [scuttlebot](https://github.com/ssbc/scuttlebot) which this was refactored out of ;) | |
| 8 … | +(such as [scuttlebot](https://github.com/ssbc/ssb-server) which this was refactored out of ;) | |
| 9 | 9 … | |
| 10 | 10 … | ## Example |
| 11 | 11 … | |
| 12 | 12 … | ``` js |
| tmpl/apis/modules/ssb-config.md | ||
|---|---|---|
| @@ -1,7 +1,7 @@ | ||
| 1 | 1 … | # ssb-config |
| 2 | 2 … | |
| 3 | -Configuration module used by [`scuttlebot`](https://github.com/ssbc/scuttlebot). | |
| 3 … | +Configuration module used by [`ssb-server`](https://github.com/ssbc/ssb-server). | |
| 4 | 4 … | |
| 5 | 5 … | ## example |
| 6 | 6 … | |
| 7 | 7 … | ``` js |
| @@ -24,9 +24,9 @@ | ||
| 24 | 24 … | * `friends.dunbar` *(number)* [`Dunbar's number`](https://en.wikipedia.org/wiki/Dunbar%27s_number). Number of nodes your instance will replicate. Defaults to `150`. |
| 25 | 25 … | * `friends.hops` *(number)* How many friend of friend hops to replicate. Defaults to `3`. |
| 26 | 26 … | * `gossip.connections` *(number)* How many other nodes to connect with at one time. Defaults to `2`. |
| 27 | 27 … | * `path` *(string)* Path to the application data folder, which contains the private key, message attachment data (blobs) and the leveldb backend. Defaults to `$HOME/.ssb`. |
| 28 | -* `master` *(array)* Pubkeys of users who, if they connect to the Scuttlebot instance, are allowed to command the primary user with full rights. Useful for remotely operating a pub. Defaults to `[]`. | |
| 28 … | +* `master` *(array)* Pubkeys of users who, if they connect to the server instance, are allowed to command the primary user with full rights. Useful for remotely operating a pub. Defaults to `[]`. | |
| 29 | 29 … | * `logging.level` *(string)* How verbose should the logging be. Possible values are error, warning, notice, and info. Defaults to `notice`. |
| 30 | 30 … | |
| 31 | 31 … | There are some configuration options for the sysadmins out there. All configuration is loaded via [`rc`](https://github.com/dominictarr/rc). You can pass any configuration value in as cli arg, env var, or in a file. |
| 32 | 32 … | |
| tmpl/apis/modules/ssb-feed.md | ||
|---|---|---|
| @@ -27,8 +27,8 @@ | ||
| 27 | 27 … | console.log(feed.keys) |
| 28 | 28 … | }) |
| 29 | 29 … | ``` |
| 30 | 30 … | |
| 31 | -This example uses `ssb-client`, but, if you're embedding `scuttlebot` or the `secure-scuttlebutt` library into your process, you can use them locally. | |
| 31 … | +This example uses `ssb-client`, but, if you're embedding `ssb-server` or the `secure-scuttlebutt` library into your process, you can use them locally. | |
| 32 | 32 … | |
| 33 | 33 … | [View on Github](https://github.com/ssbc/ssb-feed) |
| 34 | 34 … | |
| tmpl/apis/modules/ssb-party.md | ||
|---|---|---|
| @@ -19,9 +19,9 @@ | ||
| 19 | 19 … | overrides, but if the server is already running, these will not affect the existing server's config. |
| 20 | 20 … | |
| 21 | 21 … | ### Example |
| 22 | 22 … | |
| 23 | -simplest case: connect to or start a local sbot: | |
| 23 … | +simplest case: connect to or start a local ssb-server: | |
| 24 | 24 … | ``` |
| 25 | 25 … | var party = require('ssb-party') |
| 26 | 26 … | |
| 27 | 27 … | party(function (err, sbot) { |
| @@ -34,9 +34,9 @@ | ||
| 34 | 34 … | - `config.timers.keepalive`: minimum time (ms) to keep the server online after the last client disconnects. default: 30s |
| 35 | 35 … | - `config.party.out`: where to put standard output of sbot. may be a path (absolute, or relative to ssb's directory), or `false` to discard, or `true` to pass through to the controlling terminal. default: `"debug.log"` |
| 36 | 36 … | - `config.party.err`: where to put standard error of sbot. default: same as `config.party.out` |
| 37 | 37 … | |
| 38 | -[scuttlebot]: https://github.com/ssbc/scuttlebot | |
| 38 … | +[scuttlebot]: https://github.com/ssbc/ssb-server | |
| 39 | 39 … | [ssb-keys]: https://github.com/ssbc/ssb-keys |
| 40 | 40 … | [ssb-config]: https://github.com/ssbc/ssb-config |
| 41 | 41 … | [secret-stack]: https://github.com/ssbc/secret-stack |
| 42 | 42 … | |
| tmpl/apis/scuttlebot/invite.md | |||
|---|---|---|---|
| @@ -7,13 +7,13 @@ | |||
| 7 | 7 … | ||
| 8 | 8 … | Create a new invite code. | |
| 9 | 9 … | ||
| 10 | 10 … | ```bash | |
| 11 | -create {n} | ||
| 11 … | +sbot create {n} | ||
| 12 | 12 … | ``` | |
| 13 | 13 … | ||
| 14 | 14 … | ```js | |
| 15 | -create(n, cb) | ||
| 15 … | +sbot.create(n, cb) | ||
| 16 | 16 … | ``` | |
| 17 | 17 … | ||
| 18 | 18 … | This produces an invite-code which encodes the sbot server's address, and a keypair seed. | |
| 19 | 19 … | The keypair seed is used to generate a keypair, which is then used to authenticate a connection with the sbot server. | |
| @@ -27,13 +27,13 @@ | |||
| 27 | 27 … | ||
| 28 | 28 … | Use an invite code. | |
| 29 | 29 … | ||
| 30 | 30 … | ```bash | |
| 31 | -accept {invitecode} | ||
| 31 … | +sbot accept {invitecode} | ||
| 32 | 32 … | ``` | |
| 33 | 33 … | ||
| 34 | 34 … | ```js | |
| 35 | -accept(invitecode, cb) | ||
| 35 … | +sbot.accept(invitecode, cb) | ||
| 36 | 36 … | ``` | |
| 37 | 37 … | ||
| 38 | 38 … | This connects to the server address encoded in the invite-code, then calls `use()` on the server. | |
| 39 | 39 … | It will cause the server to follow the local user. | |
| @@ -45,13 +45,13 @@ | |||
| 45 | 45 … | ||
| 46 | 46 … | Use an invite code created by this sbot instance (advanced function). | |
| 47 | 47 … | ||
| 48 | 48 … | ```bash | |
| 49 | -use --feed {feedid} | ||
| 49 … | +sbot use --feed {feedid} | ||
| 50 | 50 … | ``` | |
| 51 | 51 … | ||
| 52 | 52 … | ```js | |
| 53 | -use({ feed: }, cb) | ||
| 53 … | +sbot.use({ feed: }, cb) | ||
| 54 | 54 … | ``` | |
| 55 | 55 … | ||
| 56 | 56 … | This commands the receiving server to follow the given feed. | |
| 57 | 57 … | ||
| tmpl/docs/basics/install-the-database.html.js | ||
|---|---|---|
| @@ -10,15 +10,15 @@ | ||
| 10 | 10 … | |
| 11 | 11 … | // put content in a separate function so that index.html can reuse it |
| 12 | 12 … | module.exports.content = () => ` |
| 13 | 13 … | <h2>Install the database</h2> |
| 14 | - ${ com.code({ bash: `npm install -g scuttlebot` }) } | |
| 14 … | + ${ com.code({ bash: `npm install -g ssb-server` }) } | |
| 15 | 15 … | <p> |
| 16 | 16 … | Install the database to your device, not to a host. |
| 17 | 17 … | Each user runs their own Scuttlebot. |
| 18 | 18 … | </p> |
| 19 | 19 … | <h2>Start the server</h2> |
| 20 | - ${ com.code({ bash: `sbot server` }) } | |
| 20 … | + ${ com.code({ bash: `ssb-server start` }) } | |
| 21 | 21 … | <blockquote> |
| 22 | 22 … | Scuttlebot server must be running for any of its other commands, or apps, to work. |
| 23 | 23 … | </blockquote> |
| 24 | 24 … | <h2>Next:</h2> |
| tmpl/docs/basics/open-a-client.md | ||
|---|---|---|
| @@ -1,7 +1,7 @@ | ||
| 1 | 1 … | ## Open an API client |
| 2 | 2 … | |
| 3 | -If youre using Scuttlebot from a JS application, you will need to open a client connection. | |
| 3 … | +If you're using Scuttlebot from a JS application, you will need to open a client connection. | |
| 4 | 4 … | |
| 5 | 5 … | > If you're using the command-line, you can <a href="./publish-a-message.html">skip this step.</a> |
| 6 | 6 … | |
| 7 | 7 … | ```js |
| tmpl/docs/config/configure-scuttlebot.md | ||
|---|---|---|
| @@ -24,13 +24,13 @@ | ||
| 24 | 24 … | } |
| 25 | 25 … | } |
| 26 | 26 … | ``` |
| 27 | 27 … | |
| 28 | -You can also specify config flags in the `sbot server` call. | |
| 28 … | +You can also specify config flags in the `ssb-server start` call. | |
| 29 | 29 … | For example: |
| 30 | 30 … | |
| 31 | 31 … | ```bash |
| 32 | -sbot server --port 1234 --timeout 500 | |
| 32 … | +ssb-server start --port 1234 --timeout 500 | |
| 33 | 33 … | ``` |
| 34 | 34 … | |
| 35 | 35 … | The options: |
| 36 | 36 … | |
| tmpl/docs/config/create-a-pub.html.js | ||
|---|---|---|
| @@ -20,42 +20,42 @@ | ||
| 20 | 20 … | <h2>2. Install Scuttlebot</h2> |
| 21 | 21 … | <p> |
| 22 | 22 … | Install Scuttlebot using NPM. |
| 23 | 23 … | </p> |
| 24 | - ${ com.code({ bash: `npm install -g scuttlebot` }) } | |
| 24 … | + ${ com.code({ bash: `npm install -g ssb-server` }) } | |
| 25 | 25 … | <p> |
| 26 | 26 … | To update scuttlebot in the future, simply run the global install again. |
| 27 | 27 … | </p> |
| 28 | 28 … | |
| 29 | - <h2>3. Create a run-sbot.sh script</h2> | |
| 29 … | + <h2>3. Create a run-sbotserver.sh script</h2> | |
| 30 | 30 … | <p> |
| 31 | - Save the following script somewhere easy to find, such as <code>~/run-sbot.sh</code>. | |
| 31 … | + Save the following script somewhere easy to find, such as <code>~/run-sbotserver.sh</code>. | |
| 32 | 32 … | This script will help ensure uptime, even if scuttlebot experiences a crash: |
| 33 | 33 … | </p> |
| 34 | 34 … | ${ com.code({ bash: ` |
| 35 | 35 … | #!/bin/bash |
| 36 | 36 … | while true; do |
| 37 | - sbot server --host {your-hostname} | |
| 37 … | + ssb-server start --host {your-hostname} | |
| 38 | 38 … | done |
| 39 | 39 … | ` }) } |
| 40 | 40 … | <p> |
| 41 | 41 … | Be sure to replace <code>{your-hostname}</code> with the actual hostname of your server |
| 42 | - For instance, if your server is <code>foobar.com</code>, then you should enter <code>sbot server --host foobar.com</code>. | |
| 42 … | + For instance, if your server is <code>foobar.com</code>, then you should enter <code>ssb-server start --host foobar.com</code>. | |
| 43 | 43 … | </p> |
| 44 | 44 … | |
| 45 | 45 … | <h2>4. Run the server script</h2> |
| 46 | 46 … | <p> |
| 47 | 47 … | Use a session-manager such as <a href="https://www.rackaid.com/blog/linux-screen-tutorial-and-how-to/">screen</a> or <a href="https://wiki.archlinux.org/index.php/Tmux">tmux</a> to create a detachable session. |
| 48 | 48 … | Start the session and run the script: |
| 49 | 49 … | </p> |
| 50 | - ${ com.code({ bash: `sh ~/run-sbot.sh` }) } | |
| 50 … | + ${ com.code({ bash: `sh ~/run-sbotserver.sh` }) } | |
| 51 | 51 … | <p> |
| 52 | 52 … | Then, detach the session. |
| 53 | 53 … | </p> |
| 54 | 54 … | |
| 55 | 55 … | <h2>5. Confirm Scuttlebot server is running</h2> |
| 56 | 56 … | <p> |
| 57 | - To check if sbot is running, use the following command: | |
| 57 … | + To check if the server is running, use the following command: | |
| 58 | 58 … | </p> |
| 59 | 59 … | ${ com.code({ bash: `sbot whoami` }) } |
| 60 | 60 … | <p> |
| 61 | 61 … | If all is well, your Pub's ID will be logged to the console. |
| tmpl/docs/config/creating-test-databases.md | ||
|---|---|---|
| @@ -5,8 +5,8 @@ | ||
| 5 | 5 … | To create databases for testing, you can specify a different data-directory using the `ssb_appname` environment variable. |
| 6 | 6 … | For instance: |
| 7 | 7 … | |
| 8 | 8 … | ```bash |
| 9 | -ssb_appname=test sbot server | |
| 9 … | +ssb_appname=test ssb-server start | |
| 10 | 10 … | ``` |
| 11 | 11 … | |
| 12 | 12 … | This will spawn the server with the `~/.test` data-directory. |
| tmpl/footer.part.js | ||
|---|---|---|
| @@ -9,7 +9,7 @@ | ||
| 9 | 9 … | <ul class="footer-section"> |
| 10 | 10 … | <li>Community</li> |
| 11 | 11 … | <li><p>#scuttlebutt on freenode</p></li> |
| 12 | 12 … | <li><a href="https://github.com/ssbc">GitHub Org</a></li> |
| 13 | - <li><a href="https://github.com/ssbc/scuttlebot">GitHub Repo</a></li> | |
| 13 … | + <li><a href="https://github.com/ssbc/ssb-server">GitHub Repo</a></li> | |
| 14 | 14 … | </ul> |
| 15 | 15 … | </div>` |
Built with git-ssb-web