# 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.7r1-armv6@sha256:b22005b657a0e47f2a8293f976ae72fb6f894b4792952bb13fb5bee594dd9d03
onion_service_container_state: started
onion_service_disable_healthcheck: yes
```

## Returned Variables

```
onion_service_address
```