Installation
Ory software runs on any operating system (FreeBSD, macOS, Linux, Windows, ...) and supports all major CPU platforms (ARM64, ARMv7, x86_64, x86, ...).
Ory provides pre-built binaries, Docker Images and support various package managers:
Linux
Install Ory Oathkeeper on Linux using bash <(curl ...):
bash <(curl https://raw.githubusercontent.com/ory/meta/master/install.sh) -d -b . oathkeeper <version-you-want>
./oathkeeper help
You may want to move Ory Oathkeeper to your $PATH:
sudo mv ./oathkeeper /usr/local/bin/
oathkeeper help
macOS
Install Ory Oathkeeper using homebrew on macOS:
brew install ory/tap/oathkeeper
oathkeeper help
Windows
Install Ory Oathkeeper on Windows using Scoop:
scoop bucket add ory https://github.com/ory/scoop.git
scoop install oathkeeper
oathkeeper help
Docker
Ory Oathkeeper is available as a Docker Image for all major platforms (ARM64, AMD64, ...):
docker pull oryd/oathkeeper:<version-you-want>
docker run --rm -it oryd/oathkeeper:<version-you-want> help
Kubernetes
A list of available Helm Charts for Kubernetes can be found at k8s.ory.sh/helm.
Download Binaries
You can download the client and server binaries on our Github releases page. No installer is available. You have to add the binary to the PATH in your environment yourself, for example by putting it into/usr/local/bin or something comparable.
Once installed, you should be able to run:
oathkeeper help
Building from Source
If you wish to compile the binary yourself, you need to install and set up
Go 1.17+ and add $GOPATH/bin to your $PATH.
warning
Please note that this will check out the latest commit, which might be not yet released and unstable.
git clone https://github.com/ory/oathkeeper.git
cd oathkeeper
go mod download
go install -tags sqlite,json1,hsm .
$(go env GOPATH)/bin/oathkeeper help