[{"_1":2,"_177":-5,"_178":-5},"loaderData",{"_3":4,"_17":18,"_25":26,"_153":154},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7,"_13":14,"_15":16},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","theme","system","contrast","normal","routes/_layout",{"_19":-5,"_20":21,"_22":21,"_23":11,"_24":21},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_27":28,"_29":-5,"_30":11,"_31":11,"_32":33,"_34":35,"_36":-5,"_37":11,"_38":39,"_88":-5,"_89":90,"_144":-5,"_145":11,"_146":21,"_147":11,"_148":-5,"_149":11,"_150":-5,"_151":152},"canonicalUrl","https://hub.docker.com/r/strenkml/beammp-server/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","strenkml","reponame","beammp-server","cloudBuildSource","isAutobuildsAvailable","repo",{"_40":41,"_42":43,"_45":46,"_47":48,"_49":11,"_50":51,"_52":53,"_54":55,"_57":35,"_32":33,"_58":59,"_60":-5,"_61":62,"_63":64,"_65":66,"_67":-5,"_68":62,"_69":70,"_71":11,"_72":33,"_73":74,"_79":11,"_80":81,"_85":33,"_86":87},"categories",[],"content_types",[44],"image","date_registered","2024-01-19T05:07:48.458876Z","description","Container for running a BeamMP server","is_private","last_updated","2024-08-18T00:20:02.716539Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[56],"application/vnd.oci.image.index.v1+json","name","pull_count",584,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","# Differences from original repo\n\nThe container does not depend on the environment variables. The server config is completely managed by the ServerConfig.toml file\n\n\n

\n \n

\n\n

\n $\"Release$ \n $\"Docker$ \n $\"Docker$ \n $\"trivy\"$ \n $\"os-arch\"$ \n $\"Donate$ \n

\n\n

\n This project provides a container image for the BeamMP \n game server and shows its usage in a docker-compose environment.\n

\n\n## Motivation\n\nBecause there were no well-documented BeamMP server container images out there, I did one by myself.\n\n## ⚠️ BREAKING CHANGE and migration guide ⚠️\n\nWith the latest release of this container image there were two changes that will break your current setup:\n\n1) The [environment variables](#environment-parameter) were renamed.\n2) The `ADDITIONAL_SERVER_CONFIG_TOML` no longer exists. Instead, you can now mount a custom `ServerConfig.toml` file\n to the container.\n\n**In order to migrate you have to:**\n\n1) Rename your existing environment variables to the new ones listed in the\n [environment variables](#environment-parameter) section.\n2) If you used the `ADDITIONAL_SERVER_CONFIG_TOML` environment variable, you have to create a `ServerConfig.toml` file\n and mount it to the container. See the [ServerConfig.toml](#custom-serverconfigtoml) section for more information.\n\n## Usage\n\nThe sections below provides use cases for docker and docker-compose.\n\n### docker\n\nQuick start:\n\n```bash\ndocker run --name beammp-server \\\n -p 30814:30814/tcp -p 30814:30814/udp \\\n -e BEAMMP_NAME='My first awesome Server' \\\n -e BEAMMP_AUTH_KEY='' \\\n rouhim/beammp-server\n```\n\n> If you want to interact with the server console, just add the `-it` flag to the docker run command.\n\n### docker-compose\n\nFirst clone this repository and check `docker-compose.yml` if interested. The configuration should be done within\nthe `.env` file.\n\nTo get started copy `.env.example` to `.env` and create the mod folder.\n\n```bash\ncp .env.example .env \nmkdir client-mods server-mods\nchmod 777 client-mods server-mods\n```\n\nAdjust the values in the `.env` to your needs and run:\n\n```bash\ndocker-compose pull && docker-compose up -d\n\n```\n\n### Server interaction\n\nTo connect to the interactive game server console, you need to start the server in detached (docker / -compose `-d`\nflag) mode.\nThen run the following command to attach to the server console:\n\n```bash\ndocker attach \n```\n\n## Environment parameter\n\n| Variable name | description | default value |\n|--------------------|---------------------------------------------------------------------------------------------------------------|------------------------------|\n| BEAMMP_AUTH_KEY | Mandatory! The authentication key used by the server. It is used to identify your server and is not optional. | |\n| BEAMMP_DEBUG | Set to true to enable debug output in the console. | false |\n| BEAMMP_PRIVATE | Set to true if you don't want to show up in the Server Browser. | true |\n| BEAMMP_MAX_CARS | How many vehicles a player is allowed to have at the same time. | 1 |\n| BEAMMP_MAX_PLAYERS | How many players your server can hold at a time. | 10 |\n| BEAMMP_MAP | What the server map is. | /levels/gridmap_v2/info.json |\n| BEAMMP_NAME | What your server is called. This shows up in the Server Browser. | BeamMP New Server |\n| BEAMMP_DESCRIPTION | What shows under the name when you click on the server. | BeamMP Default Description |\n| BEAMMP_PORT | This value must be identical to the containers exposed port. | 30814 |\n\nA new **auth key** can be claimed on [this site](https://beammp.com/k/dashboard), you will need\na [Discord](https://discord.com) account for this. Note that the IP entered there does *not* matter, despite what the\nsite claims. For more information refer\nto [this wiki page](https://wiki.beammp.com/en/home/server-installation#h-2-obtaining-an-authentication-key).\n\n## Client mods\n\nIn the first place you should consider\nreading [the official mods guide](https://wiki.beammp.com/en/home/server-installation#how-to-add-mods-to-your-server).\nMods can be downloaded from the [official BeamNG resources website](https://www.beamng.com/resources/). Just copy the\ndownloaded zip file into the `client-mods` folder.\n\n### Custom maps\n\nCopy the downloaded zip file into the `client-mods` folder.\n\nThen have to find out the custom map path name (e.g.: `/levels/car_jump_arena/info.json`), to set it later as the map to\nload. To do so:\n\n1. Execute the shell command below, or open the zip file manually.\n2. Copy the absolute path to the `info.json` location (`/levels/{map-name}/info.json`).\n3. Set in .env file: `BEAMMP_MAP=/levels/{map-name}/info.json`. Example: `BEAMMP_MAP=/levels/car_jump_arena/info.json`\n\nA simple way to print the full map path including info.json (_unzip_, _grep_ and _awk_ is required):\n\n```shell\nunzip -l PATH/TO/MAP.zip \\\n | grep 'levels/.*/info.json' \\\n | awk '{split($0,a,\" \"); print \"/\"a[4]}'\n```\n\n## Server mods\n\nServer mods can be found in the [BeamMP forum](https://forum.beammp.com/c/resource-plugin-area/server-resources).\nInstallation and configuration instructions are provided by each mod.\n\n### Custom ServerConfig.toml\n\nIf you want to specify a custom `ServerConfig.toml` file,\njust create a new file called `ServerConfig.toml` and fill it with your\nconfiguration ([Example](https://wiki.beammp.com/en/home/server-installation#h-4-configuration)).\nMake sure to mount the file as volume to the container.\nThe file will be mounted to the server directory on startup.\n\nDocker example:\n\n```bash\ndocker run --name beammp-server \\\n -p 30814:30814/tcp -p 30814:30814/udp \\\n -e BEAMMP_NAME='My first awesome Server' \\\n -e BEAMMP_AUTH_KEY='' \\\n -v ./ServerConfig.toml:/beammp/ServerConfig.toml \\\n rouhim/beammp-server\n```\n\nFor docker-compose, just add the following line to the `volumes` section:\n\n```yaml\nvolumes:\n - ./ServerConfig.toml:/beammp/ServerConfig.toml\n```\n\n> Environment variables will always override the values in the `ServerConfig.toml` file.\n\n> Make sure to create the file first, otherwise docker will create a directory instead.\n\n> If you are getting permission errors, you can fix them with: `chmod 777 ServerConfig.toml`\n\n## Resources\n\n- BeamMP server repository: https://github.com/BeamMP/BeamMP-Server\n- Official server maintenance guide: https://wiki.beammp.com/en/home/server-maintenance\n- Official server installation guide: https://wiki.beammp.com/en/home/server-installation\n- Inspired by: https://github.com/mastamic-ian/BeamMP_docker\n- Built from: https://github.com/RouHim/beammp-container-image\n- Built to: https://hub.docker.com/r/rouhim/beammp-server\n","has_starred","hub_user","immutable_tags_settings",{"_75":11,"_76":77},"enabled","rules",[78],".*","is_automated","permissions",{"_82":21,"_83":11,"_84":11},"read","write","admin","user","storage_size",1233585035,"orgData","recentTags",[91],{"_92":44,"_93":94,"_95":96,"_97":98,"_99":100,"_101":102,"_50":133,"_134":94,"_135":33,"_136":56,"_57":137,"_138":139,"_140":122,"_141":133,"_142":66,"_143":21},"content_type","creator",13790258,"digest","sha256:ab116ac06cb2b72ec936110e98dc3d232042102f52c60c9892857a67dc6959d3","full_size",37278052,"id",587522437,"images",[103,119,125,130],{"_104":105,"_95":106,"_107":108,"_109":110,"_111":112,"_113":114,"_115":108,"_116":-5,"_117":98,"_63":66,"_118":-5},"architecture","amd64","sha256:cb1e28cdb6f86254c8b779f50978fa99e194144aa26fdf96d138b7186e75436b","features","","last_pulled","2026-09-26T19:03:25.401715647Z","last_pushed","2024-08-18T00:20:02Z","os","linux","os_features","os_version","size","variant",{"_104":120,"_95":121,"_107":108,"_109":122,"_111":123,"_113":114,"_115":108,"_116":-5,"_117":124,"_63":66,"_118":-5},"arm64","sha256:27ac7741ca88c63253ba95ceff118d05e503ac35f2943840d9dd1241ef6c7395","2026-09-26T19:03:25.447441642Z","2024-08-18T00:20:01Z",35670733,{"_104":126,"_95":127,"_107":108,"_109":128,"_111":112,"_113":126,"_115":108,"_116":-5,"_117":129,"_63":66,"_118":-5},"unknown","sha256:ceb30ba797ae2d3256d91e59262703f1d3b547477663fea194180f35893a6c3a","2026-09-26T19:03:25.403567841Z",16685,{"_104":126,"_95":131,"_107":108,"_109":132,"_111":123,"_113":126,"_115":108,"_116":-5,"_117":129,"_63":66,"_118":-5},"sha256:bbc8f845eed58911368727d49bf688956e83e88b976e4d4364f1f7c9644b4b27","2026-09-26T19:03:25.418166878Z","2024-08-18T00:20:01.631294Z","last_updater","last_updater_username","media_type","latest","repository",22975856,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_38":155,"_162":163,"_151":175,"_176":11},{"_40":156,"_42":157,"_45":46,"_47":48,"_49":11,"_50":51,"_52":53,"_54":158,"_57":35,"_32":33,"_58":59,"_60":-5,"_61":62,"_63":64,"_65":66,"_67":-5,"_68":62,"_69":70,"_71":11,"_72":33,"_73":159,"_79":11,"_80":161,"_85":33,"_86":87},[],[44],[56],{"_75":11,"_76":160},[78],{"_82":21,"_83":11,"_84":11},"tags",{"_164":64,"_165":-5,"_166":-5,"_167":168},"count","next","previous","results",[169],{"_92":44,"_93":94,"_95":96,"_97":98,"_99":100,"_101":170,"_50":133,"_134":94,"_135":33,"_136":56,"_57":137,"_138":139,"_140":122,"_141":133,"_142":66,"_143":21},[171,172,173,174],{"_104":105,"_95":106,"_107":108,"_109":110,"_111":112,"_113":114,"_115":108,"_116":-5,"_117":98,"_63":66,"_118":-5},{"_104":120,"_95":121,"_107":108,"_109":122,"_111":123,"_113":114,"_115":108,"_116":-5,"_117":124,"_63":66,"_118":-5},{"_104":126,"_95":127,"_107":108,"_109":128,"_111":112,"_113":126,"_115":108,"_116":-5,"_117":129,"_63":66,"_118":-5},{"_104":126,"_95":131,"_107":108,"_109":132,"_111":123,"_113":126,"_115":108,"_116":-5,"_117":129,"_63":66,"_118":-5},[],"canDeleteTags","actionData","errors"]

Digest	OS/ARCH	Compressed size
cb1e28cdb6f8	linux/amd64	35.55 MB
27ac7741ca88	linux/arm64	34.02 MB

strenkml/beammp-server

Tags for strenkml/beammp-server