Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/freedomofpress/container-onion-service


https://github.com/freedomofpress/container-onion-service

containers k8s tor

Last synced: 7 days ago
JSON representation

Awesome Lists containing this project

README

        

# Onion Service

To run, set the following (here are some example values, fill in the
`<...>`):

TOR_ONION_NAME=myservice
TOR_ONION_HOSTNAME=.onion
TOR_ONION_V3_PUBLIC_KEY=
TOR_ONION_V3_SECRET_KEY=
TOR_ONION_REMOTE_PORT=80
WEB_FRONTEND_HOST=nginx.internal
WEB_FRONTEND_PORT=8000

## Client authentication

To enable client authentication (which will prevent all clients without
a key from accessing the service), mount some `*.auth` files into
`/authorized_clients` when running the container.

## Generating a key and hidden service name

To create new service names and their associated keys, run:

docker build -t onion-service.local .
docker run --rm --entrypoint gen-service-keypair onion-service.local

## Generating a client auth key

To generate a new client keypair (you can pass any number of service
names):

./gen-client-keypair .onion