zrok/README.md

48 lines
2.8 KiB
Markdown
Raw Normal View History

2023-01-17 20:24:38 +01:00
![zrok](docs/images/zrok.png)
2022-07-19 19:41:12 +02:00
2023-01-30 20:27:40 +01:00
`zrok` is a next-generation sharing platform built on top of [OpenZiti](https://docs.openziti.io), a programmable zero-trust network overlay. `zrok` is an OpenZiti _Native Application_.
2022-10-05 21:14:39 +02:00
2023-01-18 19:42:22 +01:00
`zrok` facilitates sharing resources both publicly and privately, exposing them to an audience you can easily control.
2022-10-05 21:14:39 +02:00
2023-01-18 19:41:12 +01:00
Like other offerings in this space, `zrok` allows users to create ephemeral reverse proxies ("tunnels") for `http` resources. Additionally:
2022-10-05 21:14:39 +02:00
2023-01-17 21:14:39 +01:00
* `zrok` allows users to _privately_ share resources with other `zrok` users; in _private_ usage scenarios, your private resources are not exposed to any public endpoints; all communication is securely and privately transported between `zrok` environments
* `zrok` allows sharing other types of resources; rather than just proxying `http` endpoints, `zrok` allows users to easily and rapidly share files and web content
* `zrok` is ready to be extended to easily support many kinds of decentralized resource sharing; `zrok` provides a framework that makes this kind of peer-to-peer resource sharing simple and secure
2022-10-05 21:14:39 +02:00
2023-01-31 17:53:57 +01:00
![zrok](docs/images/zrok_deployment.png)
2023-01-17 21:14:39 +01:00
## Frictionless
2022-10-05 21:14:39 +02:00
2023-01-17 21:28:12 +01:00
You can be up and sharing using the `zrok.io` service in minutes. Here is a synopsis of what's involved.
2023-01-17 21:54:37 +01:00
### First-time Setup
2023-01-17 21:14:39 +01:00
2023-01-25 16:29:31 +01:00
* Download the binary for your platform [here](https://github.com/openziti/zrok/releases)
2023-01-17 21:14:39 +01:00
* `zrok invite` to create an account with the service
* `zrok enable` to enable your shell environment for sharing with the service
2023-01-17 21:28:12 +01:00
2023-01-17 21:54:37 +01:00
### And then... sharing...
2023-01-17 21:28:12 +01:00
2023-01-17 21:54:37 +01:00
* `zrok share` to share resources immediately, simply and securely
2023-01-17 21:14:39 +01:00
2023-02-01 21:57:20 +01:00
See the [Concepts and Getting Started Guide](docs/getting-started.md) for a full overview.
2023-01-17 21:14:39 +01:00
## Self-Hosting
2023-01-18 19:41:12 +01:00
`zrok` is designed to scale up to support extremely large service instances. `zrok.io` is a public service instance operated by NetFoundry using the same code base that is available to self-hosted environments.
2023-01-17 21:14:39 +01:00
2023-02-01 16:29:29 +01:00
`zrok` is also designed to scale down to support extremely small deployments. Run `zrok` and OpenZiti on a Raspberry Pi!
2023-01-17 21:14:39 +01:00
The single `zrok` binary contains everything you need to operate `zrok` environments and also host your own service instances. Just add an OpenZiti network and you're up and running.
2023-01-17 21:14:39 +01:00
2023-02-01 16:27:41 +01:00
See the [Self-Hosting Guide](docs/guides/v0.3_self_hosting_guide.md) for details on getting your own `zrok` service instance running. This builds on top of the [OpenZiti Quick Start](https://docs.openziti.io/docs/learn/quickstarts/network/) to have a running `zrok` service instance in minutes.
## Building
2023-01-30 20:27:40 +01:00
If you are interested in building `zrok` for yourself instead of using a released package, please refer to [BUILD.md](./BUILD.md)
## Contributing
If you'd like to contribute back to `zrok`, that'd be great. Please see our [CONTRIBUTING.md](./CONTRIBUTING.md) page and
abide by the [CODE_OF_CONDUCT.md](./CODE_OF_CONDUCT.md).