Skip to content

Commit 0035d7f

Browse files
committed
update readme
1 parent ee03a3e commit 0035d7f

File tree

1 file changed

+48
-3
lines changed

1 file changed

+48
-3
lines changed

README.md

Lines changed: 48 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,52 @@
1-
Simple CLI to Deploy Static Websites to S5
1+
<h1 align="center">S5 Deploy</h1>
2+
<div align="center">
3+
<strong>
4+
Simple CLI to Deploy Static Websites to S5
5+
</strong>
6+
</div>
27

3-
⚠️⚠️⚠️ This project is under development, use with caution ⚠️⚠️⚠️
8+
![S5 CLI Demo](static/demo.cast.svg)
49

5-
### Acknowledgement
10+
## Install
11+
12+
**Single line install**:
13+
14+
```bash
15+
bash <(curl -s https://raw.githubusercontent.com/s5-dev/s5_deploy/main/install.sh)
16+
```
17+
18+
**Compile Yourself**:
19+
[Install dart](https://dart.dev/get-dart#install) first.
20+
21+
```
22+
git clone https://github.com/s5-dev/s5_deploy.git
23+
cd s5_deploy
24+
dart compile exe bin/s5_deploy.dart
25+
sudo mv ./bin/s5_deploy.exe /usr/local/bin/s5_deploy
26+
```
27+
28+
## Usage
29+
30+
```
31+
s5_deploy ./file/or/folder
32+
-V, --version Gets the version number of package
33+
-h, --help Print help dialoge.
34+
--reset Resets local node BE CAREFUL
35+
--static Skips resolver deploy
36+
-n, --node Which S5 node to deploy to
37+
(defaults to "https://s5.ninja")
38+
-S, --seed Set seed to recover DNS Link Entry
39+
-d, --dataKey Set the dataKey of the upload, defaults to target directory
40+
```
41+
42+
### Guide to Resolver Links
43+
44+
For more details on the internals, read the [S5 Docs](https://docs.sfive.net/concepts/registry.html).
45+
46+
Resolver Links are a S5 [CID](https://docs.sfive.net/concepts/content-addressed-data.html) that point to a mutable registry entry as opposed to a static dataset. This means they can be updated in the future if you wish to update the contents without changing the link. This can be especially useful when used in conjunction with [DNSLink](https://dnslink.org/) to deploy static websites to traditional domains.
47+
48+
These Resolver Links are generated with 2 components, the user seed and the corresponding dataKey. In this implementation the dataKey is directly derived from the absolute path of the directory. So as long as the path and seed don't change, s5_deploy will automatically update the registry entry without any configuration. The ability to pass a dataKey and seed exist as well if you want to change the data path or machine.
49+
50+
## Acknowledgement
651

752
This work is supported by a [Sia Foundation](https://sia.tech/) grant

0 commit comments

Comments
 (0)