{"id":15199885,"url":"https://github.com/eisengrind/docker-altv-server","last_synced_at":"2025-07-23T17:32:12.793Z","repository":{"id":39880162,"uuid":"254195255","full_name":"eisengrind/docker-altv-server","owner":"eisengrind","description":"The unofficial alt:V server Docker image.","archived":false,"fork":false,"pushed_at":"2023-11-04T22:19:37.000Z","size":460,"stargazers_count":21,"open_issues_count":1,"forks_count":18,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-08T20:09:16.309Z","etag":null,"topics":["altv","altv-server","docker","docker-altv-server","docker-image","dockerfile","dotnet","dotnetcore","dotnetcore3","eisengrind","nodejs"],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/eisengrind/altv-server","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/eisengrind.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-04-08T20:37:35.000Z","updated_at":"2024-08-31T14:18:05.000Z","dependencies_parsed_at":"2023-01-30T07:10:11.781Z","dependency_job_id":"9a29b247-55dc-4970-bdc6-66f0684dff5f","html_url":"https://github.com/eisengrind/docker-altv-server","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/eisengrind/docker-altv-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eisengrind%2Fdocker-altv-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eisengrind%2Fdocker-altv-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eisengrind%2Fdocker-altv-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eisengrind%2Fdocker-altv-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/eisengrind","download_url":"https://codeload.github.com/eisengrind/docker-altv-server/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eisengrind%2Fdocker-altv-server/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266719710,"owners_count":23973817,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-23T02:00:09.312Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["altv","altv-server","docker","docker-altv-server","docker-image","dockerfile","dotnet","dotnetcore","dotnetcore3","eisengrind","nodejs"],"created_at":"2024-09-28T02:20:17.689Z","updated_at":"2025-07-23T17:32:12.731Z","avatar_url":"https://github.com/eisengrind.png","language":"Go","readme":"\u003cp align=\"center\"\u003e\u003cimg src=\".github/assets/logo-256px.png\"\u003e\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/eisengrind/docker-altv-server/actions\"\u003e\u003cimg src=\"https://github.com/eisengrind/docker-altv-server/workflows/DefaultCI/badge.svg\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eUnofficial alt:V server Docker image\u003c/h1\u003e\n\u003cp align=\"center\"\u003e\u003ci\u003eSearching for the alt:V voice server image? \u003ca href=\"https://github.com/eisengrind/docker-altv-voice-server\"\u003eClick here\u003c/a\u003e\u003c/i\u003e\u003c/p\u003e\n\nThe unofficial alt:V server Docker image.\n\n\u003cdiv style=\"background-color: rgba(200, 0, 0, 0.4); padding: 5px 10px 10px 10px; border-radius: 10px; border: 1px solid rgba(50, 0, 0, 1)\"\u003e\n  \u003ch2\u003eBreaking Change with alt:V 9.x\u003c/h2\u003e\n  \u003cp\u003eRemoved support for .NET versions older than .NET 6\u003c/p\u003e\n\u003c/div\u003e\n\n## Usage\n\nTo get started just run the Docker image as follows:\n\n```sh\ndocker run -it --rm eisengrind/altv-server:release\n```\n\n### Configuring the alt:V server\n\nSince we can not provide a file to the alt:V without adding a volume, you can configure the alt:V server using container environment variables.\n\nSee `.docker/scripts/entrypoint.sh` for all available environment variables.\n\nBefore the server starts, the entrypoint script writes the alt:V server configuration using the input environment variables, so you don't have to provide a configuration file.\n\n## Build\n\nFor the `$build` and `$branch` variables you have to enter the regarding alt:V versioning values.\n\n**`$build`** represents the build number of the server source files. E.g. **`$build=1098`**\n\n**`$branch`** represents the branch where the server build was released. E.g. **`$branch=release`**\n\n## Using custom vehicle data\n\nTo use custom vehicle data, you can mount a volume to the directory `/opt/altv/data/`. By using the volume you can then overwrite the `vehmodels.bin` and `vehmods.bin` files.\n\nYou ofc also can just copy the vehicle data to a new `Dockerfile` that inherits from the base `eisengrind/altv-server` image.\n\n## Usage with a custom Dockerfile\n\nMost of the time if you are using containers, especially images, correctly, you will create a customized Docker image. For example by adding resources to a container which will represent a current version of your files.\n\nYou can use this images as a base for your future customizations:\n\n```Dockerfile\nFROM eisengrind/altv-server:release\n\nRUN mkdir -p /opt/altv/resources/test-resource\n```\n\nThis example, however, just creates an empty folder within the alt:V resources folder.\n\n### Note on Docker caching\n\nWe provide two different kinds of tags for the alt:V Docker images: specific and non-specific image tags.\n\nIn 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.\n\nThus, 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.\n\nThis 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.\n\n**tl;dr Keep in mind that you should always specify a specific tag in a Dockerfile.**\n\n### Note on Docker image security\n\nSince this images inherits from the `debian:buster-slim` image, we schedule nightly builds every 24 hours to reduce security invulnerabilities.\n\nWe highly recommend to update the altv-server image as frequent as possible.\n\nKeep in mind that, because of the frequent updates, we overwrite the image tags `release`, `dev`, `rc` aswell as their build versions.\n\nTo use a specific image, we recommend using their Sha-256 digest hash as an image selector.\n\n## License\n\nSee the [LICENSE](https://github.com/eisengrind/docker-altv-server/blob/master/LICENSE)-file for further information.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feisengrind%2Fdocker-altv-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feisengrind%2Fdocker-altv-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feisengrind%2Fdocker-altv-server/lists"}