Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/eisengrind/docker-altv-voice-server
A Docker image providing the alt:V voice server.
https://github.com/eisengrind/docker-altv-voice-server
altv altv-server altv-voice-server docker eisengrind gta5 gta5-multiplayer gtav gtav-multiplayer server voice voice-server
Last synced: 5 days ago
JSON representation
A Docker image providing the alt:V voice server.
- Host: GitHub
- URL: https://github.com/eisengrind/docker-altv-voice-server
- Owner: eisengrind
- License: mit
- Created: 2020-05-23T17:21:54.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-01-19T09:56:13.000Z (10 months ago)
- Last Synced: 2024-06-21T14:05:57.175Z (5 months ago)
- Topics: altv, altv-server, altv-voice-server, docker, eisengrind, gta5, gta5-multiplayer, gtav, gtav-multiplayer, server, voice, voice-server
- Language: Go
- Homepage: https://hub.docker.com/r/eisengrind/altv-voice-server
- Size: 216 KB
- Stars: 8
- Watchers: 2
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Unofficial alt:V voice server Docker image
Searching for the alt:V server image? Click here
A Docker image providing the alt:V voice server.
## Usage
```sh
docker run --rm -it eisengrind/altv-voice-server:release
```
To the a full list of the latest tags and release of this Docker image, see the image on [Docker Hub](https://hub.docker.com/r/eisengrind/altv-voice-server).
### Environment variables
Here is a list of all available environment variables this image uses. The image maps environment variables to the voice server config file.
Variable | Default value | Description
--- | --- | ---
`ALTV_VOICE_SERVER_HOST` | `0.0.0.0` | The voice server host address on which the voice is reachable for the alt:V server.
`ALTV_VOICE_SERVER_PORT` | `7798` | The voice server port on which the voice server is reachable for the alt:V server.
`ALTV_VOICE_SERVER_PLAYER_HOST` | `0.0.0.0` | A (static) ip on which the voice server is reachable for clients connected to the alt:V server.
`ALTV_VOICE_SERVER_PLAYER_PORT` | `7799` | The voice server port on which the voice server is reachable for clients connected to the alt:V server.
`ALTV_VOICE_SERVER_SECRET` | `1234` | A secret that the alt:V server uses to authenticate against the voice server.
To use the environment variable when starting this Docker image:
```sh
docker run --rm -it -e ALTV_VOICE_SERVER_SECRET=123456789 eisengrind/altv-voice-server:release
```
sets the voice server secret to `123456789`. See the [Docker documentation on environment variables](https://docs.docker.com/engine/reference/commandline/run/#set-environment-variables--e---env---env-file).
### Note on Docker caching
We provide two different kinds of tags for the alt:V Docker images: specific and non-specific image tags.
In general, this means that specific tags represent a unique alt:V build version whereas a non-specific tag such as `release...` or `dev...` represents the latest build number of the regarding branch.
Thus, once an image with a non-specific tag is pulled, this image will not automatically get updated by Docker unless you remove and pull the image again from Docker Hub.
This is why we provide specific tags. Those kind of tags do explicitly not lead to a caching problem, because specific tags are not meant to be, once they are published, changed.
**tl;dr Keep in mind that you should always specify a specific tag in a Dockerfile.**
### Note on Docker image security
Since this images inherits from the `debian:buster-slim` image, we schedule nightly builds every 24 hours to reduce security invulnerabilities.
We highly recommend to update the altv-server image as frequent as possible.
Keep in mind that, because of the frequent updates, we overwrite the image tags `release`, `dev`, `rc` aswell as their build versions.
To use a specific image, we recommend using their Sha-256 digest hash as an image selector.
## License
See the [LICENSE](https://github.com/eisengrind/docker-altv-voice-server/blob/master/LICENSE)-file for further information.