mirror of
https://github.com/PR0M3TH3AN/VoxVera.git
synced 2026-10-27 09:40:40 +00:00
49 lines
1.4 KiB
Markdown
49 lines
1.4 KiB
Markdown
# Docker Usage
|
|
|
|
Experimental: the container path is not yet a production-grade hidden-service deployment target. Linux with `systemd --user` remains the supported persistent-host environment.
|
|
|
|
A prebuilt image containing Tor, OnionShare and the `voxvera` CLI is published to
|
|
`ghcr.io/voxvera/voxvera`.
|
|
|
|
```bash
|
|
# pull the image
|
|
docker pull ghcr.io/voxvera/voxvera:latest
|
|
|
|
# run the experimental container with flyers stored in ./flyers
|
|
mkdir -p flyers
|
|
docker run -d \
|
|
--name voxvera \
|
|
--restart unless-stopped \
|
|
-v "$(pwd)/flyers:/flyers" \
|
|
ghcr.io/voxvera/voxvera:latest
|
|
```
|
|
|
|
The container now uses a dedicated entrypoint that:
|
|
- stores runtime state under `/flyers`
|
|
- seeds `/flyers/config.json` if needed
|
|
- starts an in-container Tor daemon on `127.0.0.1:9050/9051`
|
|
- bootstraps a default site when `/flyers/host` is empty
|
|
- runs `voxvera start-all` on startup and retries it periodically
|
|
- exposes a container healthcheck based on `voxvera doctor --json`
|
|
|
|
Useful commands:
|
|
|
|
```bash
|
|
docker logs -f voxvera
|
|
docker exec -it voxvera voxvera doctor --json
|
|
docker exec -it voxvera voxvera autostart status --json
|
|
```
|
|
|
|
If you prefer Compose:
|
|
|
|
```yaml
|
|
services:
|
|
voxvera:
|
|
image: ghcr.io/voxvera/voxvera:latest
|
|
restart: unless-stopped
|
|
volumes:
|
|
- ./flyers:/flyers
|
|
```
|
|
|
|
Use this path for testing only until the container runtime and background recovery behavior are validated end-to-end.
|