-
Notifications
You must be signed in to change notification settings - Fork 45
chore: lint Dockerfile and add documentation/examples #51
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Open
azgaviperr
wants to merge
14
commits into
acemod:main
Choose a base branch
from
azgaviperr:main
base: main
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
Open
Changes from 3 commits
Commits
Show all changes
14 commits
Select commit
Hold shift + click to select a range
226242e
chore: lint Dockerfile and add documentation/examples
azgaviperr b7e6ab3
Update README.md to improve documentation clarity
azgaviperr aba150c
Split documentation for easier use and maintainability
azgaviperr 68769d6
Update docs/advanced-usage/index.md
azgaviperr 53039c3
Update docs/advanced-usage/index.md
azgaviperr ff0ebe8
Update docs/advanced-usage/index.md
azgaviperr e14abf0
Update docs/advanced-usage/index.md
azgaviperr a253602
Update docs/getting-started/index.md
azgaviperr bea0f66
Update docs/getting-started/index.md
azgaviperr ad1187f
Update README.md
azgaviperr 897134c
Update README.md
azgaviperr 99b79be
Update docs/advanced-usage/index.md
azgaviperr 35164fb
docs: update advanced usage guide with @hafometh88's change proposal
azgaviperr b32cada
fix: remove unnecessary quotes in port mappings in example compose files
azgaviperr File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,83 +1,57 @@ | ||
| # Arma Reforger Dedicated Server | ||
|
|
||
| An Arma Reforger dedicated server. Updates to the latest version every time it is restarted. | ||
| A lightweight and automated solution for running an Arma Reforger dedicated server. This project ensures your server is always up-to-date with the latest version. | ||
|
|
||
| ## Usage | ||
| ## Quick Start | ||
|
|
||
| ### Docker CLI | ||
| ### Using Docker CLI | ||
|
|
||
| Run the following command to create and start the server: | ||
|
|
||
| ```sh | ||
| docker create \ | ||
| --name=reforger-server \ | ||
| -p 2001:2001/udp \ | ||
| -v path/to/configs:/reforger/Configs \ | ||
| -v path/to/profiles:/home/profile \ | ||
| -v path/to/workshop:/reforger/workshop \ | ||
| -e SERVER_PUBLIC_ADDRESS="public ip" \ | ||
| -e GAME_NAME="My Docker Reforger Server" \ | ||
| ghcr.io/acemod/arma-reforger:latest | ||
| docker create \ | ||
| --name=reforger-server \ | ||
| -p 2001:2001/udp \ | ||
| -v path/to/configs:/reforger/Configs \ | ||
| -v path/to/profiles:/home/profile \ | ||
| -v path/to/workshop:/reforger/workshop \ | ||
| -e SERVER_PUBLIC_ADDRESS="your.public.ip" \ | ||
| -e GAME_NAME="My Reforger Server" \ | ||
| ghcr.io/acemod/arma-reforger:latest | ||
| docker start reforger-server | ||
| ``` | ||
|
|
||
| If an admin password is not provided, one will be generated and printed to the console. | ||
|
|
||
| ### Docker-compose | ||
|
|
||
| Simply check-out / copy [the provided docker-compose.yml](docker-compose.yml) and adjust to your personal needs. | ||
|
|
||
| ## Parameters | ||
|
|
||
| Check [the Dockerfile](Dockerfile#L32-L67), more docs will come later. | ||
|
|
||
| ### Configs | ||
|
|
||
| By default the configs are generated from the ENV variables in the dockerfile. After the first run the file can be expanded with additional options manually, but the fields will always be overwritten by the ENV variables. | ||
|
|
||
| Alternatively, change the `ARMA_CONFIG` variable to a file present in the `Configs` volume. It will be used without modification. | ||
|
|
||
| ### Experimental server | ||
| > **Note**: If you don't provide an admin password, one will be generated and displayed in the console. | ||
|
|
||
| To use the experimental server instead of the regular set `STEAM_APPID` variable to `1890870`. | ||
| ### Using Docker Compose | ||
|
|
||
| ### Mods | ||
| 1. Clone the repository and navigate to the `docker-compose-examples` folder. | ||
| 2. Choose a `docker-compose.yml` file that suits your needs and adjust it as necessary. | ||
| 3. Start the server: | ||
|
|
||
| Workshop mods can be defined in two ways. You can use both or either of those. | ||
| ```bash | ||
| docker-compose up -d | ||
| ``` | ||
|
|
||
| #### GAME_MODS_IDS_LIST | ||
| 4. Stop the server: | ||
|
|
||
| A comma separated list of IDs, with an optional version. | ||
| ```bash | ||
| docker-compose down | ||
azgaviperr marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
| ``` | ||
|
|
||
| ```sh | ||
| -e GAME_MODS_IDS_LIST="5965770215E93269=1.0.6,5965550F24A0C152" | ||
| ``` | ||
| ## Learn More | ||
|
|
||
| #### GAME_MODS_JSON_FILE_PATH | ||
| For detailed configuration options, advanced usage, and troubleshooting, refer to the [documentation](docs/index.md). | ||
|
|
||
| Path to a JSON file that contains array of mod objects. | ||
| - **Environment Variables**: Customize your server with a wide range of options. | ||
| - **Mods Support**: Add mods using environment variables or JSON files. | ||
| - **Multiple Instances**: Run multiple servers on the same machine. | ||
| - **RCON**: Enable and configure remote server control. | ||
|
|
||
| ```sh | ||
| -v ${PWD}/mods_file.json:/mods_file.json | ||
| -e GAME_MODS_JSON_FILE_PATH="/mods_file.json" | ||
| ``` | ||
| ## Contributing | ||
|
|
||
| ```json | ||
| [ | ||
| { | ||
| "modId": "597706449575D90B", | ||
| "version": "1.1.1" | ||
| } | ||
| ] | ||
| ``` | ||
| ### RCON | ||
|
|
||
| RCON can be activated by defining the `RCON_PASSWORD` variable. | ||
|
|
||
| ```sh | ||
| -e RCON_PASSWORD="ExamplePassword123" | ||
| ``` | ||
| Contributions are welcome! Feel free to submit issues or pull requests to improve the project. | ||
|
|
||
| The password: | ||
| * is required for RCON to start | ||
| * does not support spaces | ||
| * must be at least 3 characters long | ||
| --- | ||
|
|
||
| Use `-e RCON_PERMISSION=""` to change [permission](https://community.bistudio.com/wiki/Arma_Reforger:Server_Config#permission) for all RCON clients. | ||
| Get started today and enjoy a seamless Arma Reforger server experience! | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.