{"id":16696434,"url":"https://github.com/adaliszk/valheim-server","last_synced_at":"2025-08-30T12:15:44.670Z","repository":{"id":40696513,"uuid":"344196804","full_name":"adaliszk/valheim-server","owner":"adaliszk","description":"A simple, lightweight and secure Valheim Dedicated Server docker image with Kubernetes Helm chart support.","archived":false,"fork":false,"pushed_at":"2024-09-03T21:20:41.000Z","size":31680,"stargazers_count":40,"open_issues_count":4,"forks_count":8,"subscribers_count":5,"default_branch":"develop","last_synced_at":"2025-08-28T12:33:34.847Z","etag":null,"topics":["backups","chart","docker","kubernetes","valheim-docker","valheim-server"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/adaliszk.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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":"2021-03-03T16:49:15.000Z","updated_at":"2025-02-04T11:21:12.000Z","dependencies_parsed_at":"2023-02-02T19:18:47.408Z","dependency_job_id":"d30bad1d-aac2-4462-a226-6a64cda80a34","html_url":"https://github.com/adaliszk/valheim-server","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/adaliszk/valheim-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adaliszk%2Fvalheim-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adaliszk%2Fvalheim-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adaliszk%2Fvalheim-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adaliszk%2Fvalheim-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/adaliszk","download_url":"https://codeload.github.com/adaliszk/valheim-server/tar.gz/refs/heads/develop","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adaliszk%2Fvalheim-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272847292,"owners_count":25003165,"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-08-30T02:00:09.474Z","response_time":77,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","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":["backups","chart","docker","kubernetes","valheim-docker","valheim-server"],"created_at":"2024-10-12T17:28:33.129Z","updated_at":"2025-08-30T12:15:44.645Z","avatar_url":"https://github.com/adaliszk.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Docker Pulls](https://img.shields.io/docker/pulls/adaliszk/valheim-server?label=Docker%20Pulls)](https://hub.docker.com/r/adaliszk/valheim-server)\n[![:latest image size](https://img.shields.io/docker/image-size/adaliszk/valheim-server/latest?label=Image%20Size)](https://hub.docker.com/r/adaliszk/valheim-server)\n[![server build](https://github.com/adaliszk/valheim-server/actions/workflows/cd-server.yml/badge.svg?label=Server)](https://github.com/adaliszk/valheim-server/actions/workflows/cd-server.yml)\n[![monitoring build](https://github.com/adaliszk/valheim-server/actions/workflows/cd-monitoring.yml/badge.svg?label=Monitoring)](https://github.com/adaliszk/valheim-server/actions/workflows/cd-monitoring.yml)\n[![helm build](https://github.com/adaliszk/valheim-server/actions/workflows/cd-helm.yml/badge.svg)](https://github.com/adaliszk/valheim-server/actions/workflows/cd-helm.yml)\n[![license](https://img.shields.io/github/license/adaliszk/valheim-server?label=License)](https://github.com/adaliszk/valheim-server/LICENSE.md)\n\n# Valheim Docker Server \u0026 Helm Chart\nClean, fast and standalone Docker \u0026 Kubernetes helm deployments.\n\nWhile there are many other images out there, they tend to fall into the bad habit of using anti-patterns, like using\nSupervisor and Cron in a single image. The images included here aim to avoid these bad habits, while still offering a\nfull feature-set for managing and monitoring your Valheim Server.\n\n\n## What features do the images have?\n- A fully working Valheim Server **without the need of steam downloading** anything from the internet.\n- Using a **non-root user** to mitigate potential vulnerabilities.\n- **Gracefully stops the server**; enables proper saving before shutdown to avoid world corruption.\n- **Automatic Backup** of the world files when the server saves them onto the disk.\n- **Sanitized server output**; say goodbye to the debug noise that is not important!\n- Health-checks to monitor the image's basic status\n- Companion image for monitoring: [adaliszk/valheim-server-monitoring](https://hub.docker.com/r/adaliszk/valheim-server-monitoring)\n\u003c!--\n- Helm chart for Kubernetes: [https://charts.adaliszk.io](https://charts.adaliszk.io/chart/?name=valheim-server)\n--\u003e\n\n## Server:\n[`adaliszk/valheim-server`](https://hub.docker.com/r/adaliszk/valheim-server)\n\nAlternatives:\n[`ghcr.io/adaliszk/valheim-server`](https://ghcr.io/adaliszk/valheim-server),\n[`quay.io/adaliszk/valheim-server`](https://quay.io/adaliszk/valheim-server)\n\n- `vanilla` `latest` - always the latest stable build of the server\n- `0.218.21`, `0.218` - the server version released on 27/08/2024\n- `bepinex-5.4.2202` `bepinex-5.4.21` `bepinex-5.4` `bepinex` - latest server using [denkinson's BepInEx](https://valheim.thunderstore.io/package/denikson/BepInExPack_Valheim) mod loader\n- `plus-0.9.9.11` `plus-0.9.9`  `plus-0.9` `plus` - the latest server using [Valheim Plus](https://github.com/valheimPlus/ValheimPlus) mod\n- `develop` - build any actively testing branch\n\nadditionally, there are version prefixed tags from `bepinex`, and `plus` variants, so you could specify exactly which\nserver you want to use, like: `0.204.04-bepinex-5.4.1601`\n\n```bash\ndocker run -p 2456-2457:2456-2457/udp adaliszk/valheim-server -name \"My Server\" -password=\"super!secret\"\n```\n\nor\n\n```yaml\nversion: \"3.8\"\nservices:\n\n  valheim:\n    image: adaliszk/valheim-server\n    environment:\n      SERVER_NAME: \"My custom message in the server list\"\n      SERVER_PASSWORD: \"super!secret\"\n    ports:\n      - 2456:2456/udp\n      - 2457:2457/udp\n```\n\n[More details about using this image](docs/vanilla/README.md)\n\n## Kubernetes deployment:\n\n```bash\nhelm repo add adaliszk https://charts.adaliszk.io\nhelm upgrade --install --create-namespace --wait my-valheim-server adaliszk/valheim-server\n```\n\n## Monitoring companion:\n[`adaliszk/valheim-server-monitoring`](https://hub.docker.com/r/adaliszk/valheim-server-monitoring)\n\nAlternatives:\n[`ghcr.io/adaliszk/valheim-server-monitoring`](https://ghcr.io/adaliszk/valheim-server-monitoring),\n[`quay.io/adaliszk/valheim-server-monitoring`](https://quay.io/adaliszk/valheim-server-monitoring)\n\n- `metrics` - mtail metrics from the latest server version\n- `prometheus` - a pre-configured prometheus for docker environments\n\n```bash\ndocker run --name my_server -d -p 2456-2457:2456-2457/udp adaliszk/valheim-server\ndocker run -d --volumes-from my_server:ro -d -p 3903:3903 adaliszk/valheim-server-monitoring:metrics\n```\n\nor\n\n```yaml\nversion: \"3.8\"\nvolumes:\n  - logs: {}\nservices:\n\n  valheim:\n    image: adaliszk/valheim-server\n    environment:\n      SERVER_NAME: \"My custom message in the server list\"\n      SERVER_PASSWORD: \"super!secret\"\n    volumes:\n      - logs:/logs\n    ports:\n      - 2456:2456/udp\n      - 2457:2457/udp\n\n  metrics:\n    image: adaliszk/valheim-server-monitoring:metrics\n    volumes:\n      - logs:/logs:ro\n    ports:\n      - 3903:3903\n```\n\n## Examples\n- [Basic Docker setup using Docker managed volumes](docs/basic-Docker-setup.md)\n- [Basic Docker-Compose setup](docs/basic-Docker-Compose-setup.md)\n- [Basic Docker-Compose setup (docker-compose.yml)](docs/examples/compose-simple.yml)\n- [Basic Compose with Modded server (docker-compose.yml)](docs/examples/compose-modded.yml)\n- [Export Metrics with MTail](docs/export-metrics-with-MTail.md)\n- [Export Metrics with MTail (docker-compose.yml)](docs/examples/compose-with-metrics.yml)\n\n\n## Contributions\nFeel free to open Tickets or Pull-Requests, however, keep in mind that the idea is to keep it simple, and separate the\nconcerns into multiple small images that are ready without needing to download anything from the internet.\n\nIf you have questions, please use the [Discussions](https://github.com/adaliszk/valheim-server/discussions) tab or ping\nme on the [Valheim Discord server](https://discord.gg/valheim): `Kicsivazz#2537`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadaliszk%2Fvalheim-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadaliszk%2Fvalheim-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadaliszk%2Fvalheim-server/lists"}