# Ansible Role: Tor Onion Service

## Required Variables

```yaml
onion_service_container_name: onion_service
onion_service_virtual_port: 80
onion_service_target: 1.2.3.4:8080
onion_service_non_anonymous_single_hop_mode: 0 # or 1
onion_service_network_name: webserver
```

## Optional Variables

```yaml
onion_service_container_image: docker.io/fphammerle/onion-service:3.1.0-tor0.4.7.8r0-armv6@sha256:ecbaa2642490ea63da6019b3ecd8b5027913eefa0b40331e9f20f4abd7216fd9
onion_service_container_state: started
onion_service_disable_healthcheck: yes
```

## Returned Variables

```
onion_service_address
```