Geo-scale, next-generation peer-to-peer sharing platform built on top of OpenZiti.
Go to file
2023-08-18 16:22:17 -04:00
.github/workflows stop prereleasing container images; fixes #343 2023-08-09 09:39:20 -04:00
bin initial rough pass for a stored token implementation 2023-01-09 11:00:37 -06:00
build v0.4 series 2023-03-30 18:57:27 -04:00
cmd/zrok 'zrok overview' updated for sdk changes (#374) 2023-07-19 11:51:02 -04:00
controller update sdk-golang dependency to correct openziti identity creation issue (#389) 2023-08-18 16:22:17 -04:00
docker preen Docker share guides for 0.4 2023-06-13 14:25:14 -04:00
docs Merge pull request #382 from openziti/v0.4_zrok_sdk 2023-07-31 15:17:24 -04:00
endpoints generalized implementation of public/private share (#34) 2023-07-17 16:45:20 -04:00
environment default behavior for environment.LoadRoot was returning nil when it should have been returning an env_core.Root stub (#383) 2023-07-31 18:01:23 -04:00
etc reference configuration lint; aligning with metrics docs example 2023-06-21 10:16:12 -04:00
rest_client_zrok Enhanced password requirements and relevant ui changes 2023-05-23 10:51:15 -05:00
rest_model_zrok Enhanced password requirements and relevant ui changes 2023-05-23 10:51:15 -05:00
rest_server_zrok health check endpoint for checking both the SQL store and also influx (#372) 2023-08-08 13:48:34 -04:00
sdk copyto/pastefrom tweaks + readme (#379) 2023-07-31 13:53:49 -04:00
specs Enhanced password requirements and relevant ui changes 2023-05-23 10:51:15 -05:00
tui seriousbusiness 2023-01-13 14:36:07 -05:00
ui health check endpoint for checking both the SQL store and also influx (#372) 2023-08-08 13:48:34 -04:00
util ensure supplied email addresses are valid at both the CLI and the API (#108) 2022-11-29 13:23:23 -05:00
website organize metrics and limits guides under self-hosting 2023-07-27 11:15:08 -04:00
.gitignore apiEndpoint validation tweaks (#260) 2023-03-10 16:33:58 -05:00
.goreleaser-darwin.yml openziti-rest-kitchen -> openziti (#158) 2023-01-13 15:01:34 -05:00
.goreleaser-linux-arm64.yml publish Docker images for amd64,arm64 2023-02-09 11:22:08 -05:00
.goreleaser-linux-armhf.yml publish Docker images for amd64,arm64 2023-02-09 11:22:08 -05:00
.goreleaser-linux.yml publish Docker images for amd64,arm64 2023-02-09 11:22:08 -05:00
.goreleaser-release.yml fully cross-platform build? (#70) 2022-11-03 16:51:22 -04:00
.goreleaser-windows.yml openziti-rest-kitchen -> openziti (#158) 2023-01-13 15:01:34 -05:00
BUILD.md rearranging getting started to use v3 2023-01-30 13:45:12 -05:00
CHANGELOG.md v0.4.5 wip; changelog 2023-08-08 13:49:42 -04:00
CODE_OF_CONDUCT.md add standard markdowns, start to fill them out 2023-01-27 08:28:50 -05:00
CONTRIBUTING.md add standard markdowns, start to fill them out 2023-01-27 08:28:50 -05:00
go.mod update sdk-golang dependency to correct openziti identity creation issue (#389) 2023-08-18 16:22:17 -04:00
go.sum update sdk-golang dependency to correct openziti identity creation issue (#389) 2023-08-18 16:22:17 -04:00
LICENSE add LICENSE 2023-01-30 13:22:37 -05:00
README.md Fixing the link to the self-hosting guide 2023-07-01 12:54:48 +02:00
SECURITY.md add standard markdowns, start to fill them out 2023-01-27 08:28:50 -05:00

zrok

zrok is a next-generation sharing platform built on top of OpenZiti, a programmable zero-trust network overlay. zrok is a Ziti Native Application.

zrok facilitates sharing resources both publicly and privately, exposing them to an audience you can easily control.

Like other offerings in this space, zrok allows users to create ephemeral reverse proxies ("tunnels") for http resources. Additionally:

  • 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

zrok

Frictionless

You can be up and sharing using the zrok.io service in minutes. Here is a synopsis of what's involved.

First-time Setup

  • Download the binary for your platform here
  • zrok invite to create an account with the service
  • zrok enable to enable your shell environment for sharing with the service

And then... sharing...

  • zrok share to share resources immediately, simply and securely

See the Concepts and Getting Started Guide for a full overview.

Self-Hosting

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.

zrok is also designed to scale down to support extremely small deployments. Run zrok and OpenZiti on a Raspberry Pi!

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.

See the Self-Hosting Guide for details on getting your own zrok service instance running. This builds on top of the OpenZiti Quick Start to have a running zrok service instance in minutes.

Building

If you are interested in building zrok for yourself instead of using a released package, please refer to BUILD.md

Contributing

If you'd like to contribute back to zrok, that'd be great. Please see our CONTRIBUTING.md page and abide by the CODE_OF_CONDUCT.md.