{"id":31564972,"url":"https://github.com/brammys/necesse-docker-server","last_synced_at":"2026-03-10T05:01:56.554Z","repository":{"id":60634123,"uuid":"543613747","full_name":"BrammyS/necesse-docker-server","owner":"BrammyS","description":"A Docker Image to run your own self-hosted Necesse game server.","archived":false,"fork":false,"pushed_at":"2026-01-31T09:31:59.000Z","size":295,"stargazers_count":65,"open_issues_count":0,"forks_count":13,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-01-31T22:20:24.423Z","etag":null,"topics":["didicated","docker","game","linux","necesse","server","ubuntu"],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/brammys/necesse-server","language":"Dockerfile","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/BrammyS.png","metadata":{"files":{"readme":".github/README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"Brammys","patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":null}},"created_at":"2022-09-30T13:27:50.000Z","updated_at":"2026-01-31T09:32:03.000Z","dependencies_parsed_at":"2024-02-15T11:27:05.974Z","dependency_job_id":"23bb0b80-dca5-48d4-ae42-65f5ba9d9da5","html_url":"https://github.com/BrammyS/necesse-docker-server","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/BrammyS/necesse-docker-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BrammyS%2Fnecesse-docker-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BrammyS%2Fnecesse-docker-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BrammyS%2Fnecesse-docker-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BrammyS%2Fnecesse-docker-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BrammyS","download_url":"https://codeload.github.com/BrammyS/necesse-docker-server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BrammyS%2Fnecesse-docker-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30325598,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-10T01:36:58.598Z","status":"online","status_checked_at":"2026-03-10T02:00:06.579Z","response_time":106,"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":["didicated","docker","game","linux","necesse","server","ubuntu"],"created_at":"2025-10-05T06:26:00.910Z","updated_at":"2026-03-10T05:01:56.540Z","avatar_url":"https://github.com/BrammyS.png","language":"Dockerfile","funding_links":["https://github.com/sponsors/Brammys"],"categories":[],"sub_categories":[],"readme":"[![Docker Image Size](https://img.shields.io/docker/image-size/brammys/necesse-server/latest)](https://hub.docker.com/r/brammys/necesse-server)\n\n# Necesse-docker-server\n\nStart your own dedicated Necesse server with a **single** command!\n\n## Examples\n\n### New world\n\nThe following command creates a server with `strong_pass` for the password.\nAnd it also generates a new world.\n\n```bash\ndocker run -d \\\n    -v /necesse/saves:/necesse/saves \\\n    -p 14159:14159/udp \\\n    -e PASSWORD=strong_pass \\\n    -e PAUSE=1 \\\n    --restart=always \\\n    --name necesse-server \\\n    brammys/necesse-server\n```\n\n### Existing world\n\nFirst move your existing `WORLD_NAME` file to the `/necesse/saves` directory.\nUse the following command to start your server with your provided world.\nBe sure to replace `WORLD_NAME` with your actual world name.\n\n```bash\ndocker run -d \\\n    -v /necesse/saves:/necesse/saves \\\n    -p 14159:14159/udp \\\n    -e PASSWORD=strong_pass \\\n    -e PAUSE=1 \\\n    -e WORLD=WORLD_NAME \\\n    --restart=always \\\n    --name necesse-server \\\n    brammys/necesse-server\n```\n\n### Docker-compose\n\nYou can also use the provided [docker-compose.yaml](https://github.com/BrammyS/necesse-docker-server/blob/main/docker-compose.yaml) file.\nUse the following command to start your dedicated server with docker-compose.\n\n```bash\ndocker-compose up -d\n```\n\n## Supported tags\n\nAll suported tags can be found on [dockerhub](https://hub.docker.com/r/brammys/necesse-server/tags).\n\n## Configurations\n\n### Environment variables\n\n| ENV variable    \t    | Default value           \t                    | Description                                                                            \t                                             |\n|-------------------\t|-------------------------------------------\t|------------------------------------------------------------------------------------------------------------------------------------    |\n| `WORLD`            \t| `world` \t                                    | The name of the world that will be used.                                                                                               |\n| `SLOTS`            \t| `10` \t                                        | The Amount of player slots.                                                                                                            |\n| `OWNER`            \t| `` \t                                        | Anyone that connects with this name, will get owner permissions.                                                                       |\n| `MOTD`            \t| `\"This server is made possible by Docker!\"`   | Sets the message of the day. Use \\n for new line.                                                                                      |\n| `PASSWORD`            | `` \t                                        | The password for the server, blank for no password.                                                                                    |\n| `GIVE_CLIENTS_POWER`  | `1` \t                                        | If the server should check client actions, a kind of anti-cheat. When this setting is on it will give a much smoother experience for clients. (`0` off, `1` on)                    |\n| `PAUSE`            \t| `0` \t                                        | Pauses the world when there are no players in server. (`0` off, `1` on)                                                                |\n| `LOGGING`            \t| `1` \t                                        | Generate a log file for each session. (`0` off, `1` on)                                                                                |\n| `ZIP`            \t    | `1` \t                                        | Whether saves should be compressed. (`0` off, `1` on)                                                                                  |\n| `JVMARGS`            \t| `` \t                                        | Any extra arguments to supply to the JVM via the [java command](https://docs.oracle.com/en/java/javase/17/docs/specs/man/java.html).   |\n\n### Volumes\n\n| Path             | Description                                               |\n| ---------------- | --------------------------------------------------------- |\n| `/necesse/saves` | The folder containing all the world saves.                |\n| `/necesse/logs`  | The folder containing all the logs of the server.         |\n| `/necesse/cfg`   | The folder containing all the server configuration files. |\n\n### Ports\n\n| Port        | Description                        |\n| ----------- | ---------------------------------- |\n| `14159/udp` | The game runs on UDP port `14159`. |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrammys%2Fnecesse-docker-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbrammys%2Fnecesse-docker-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrammys%2Fnecesse-docker-server/lists"}