wala-rust

Content-adressed HTTP file server
Info | Log | Files | Refs | README | LICENSE

README.adoc (1252B)


      1 Wala
      2 ====
      3 
      4 HTTP service that makes uploaded content available at the path of its digests(s)
      5 
      6 Currently only `SHA256` is supported.
      7 
      8 CAUTION: Wala is not intended to be used by itself in a production environment. Please consider setting a reverse proxy in front of it.
      9 
     10 
     11 
     12 Install
     13 -------
     14 
     15 defalsify.org hosts a pre-assembled crate for `wala`.
     16 
     17 To install, first addthe defalsify registry to `.cargo/config.toml`:
     18 
     19 [source,bash]
     20 	[registries]
     21 	...
     22 	defalsify = { index = "sparse+https://defalsify.org/pub/rust/" }
     23 
     24 Then install with this command:
     25 
     26 `cargo install --registry defalsify --all-features --release`
     27 
     28 
     29 Build
     30 -----
     31 
     32 To build from source:
     33 
     34 `rustup run 1.67 cargo build -v --bin wala --all-features --release`
     35 
     36 
     37 Running
     38 -------
     39 
     40 `./target/release/wala -d <storage_directory>`
     41 
     42 Logging output detail can be adjusted by setting environment variable RUST_LOG to debug, info, warn or error.
     43 
     44 `./target/release/wala --help` for more options.
     45 
     46 .Example interaction
     47 
     48 [source,bash]
     49 curl -X PUT http://localhost:8000 --data "foo"
     50 2c26b46b68ffc68ff99b453c1d30413413422d706483bfa0f98a5e886266e7ae
     51 curl -X GET http://localhost:8000/2c26b46b68ffc68ff99b453c1d30413413422d706483bfa0f98a5e886266e7ae
     52 foo
     53 
     54 
     55 
     56 Known issues
     57 ------------
     58 
     59 `wala_send` is broken `:'(`