From e08dd64c7930d0e2b9dc0837784f3d03d0151f9c Mon Sep 17 00:00:00 2001 From: Lachlan Maclean Date: Fri, 17 Jun 2022 03:40:59 +1200 Subject: Add Docker image install instructions (#77) --- docs/SUMMARY.md | 3 +- .../guides/README.md | 12 +++ .../guides/pg9182-docker-installation-guide.md | 88 ++++++++++++++++++++++ .../hosting-guides.md | 12 --- 4 files changed, 102 insertions(+), 13 deletions(-) create mode 100644 docs/hosting-a-server-with-northstar/guides/README.md create mode 100644 docs/hosting-a-server-with-northstar/guides/pg9182-docker-installation-guide.md delete mode 100644 docs/hosting-a-server-with-northstar/hosting-guides.md (limited to 'docs') diff --git a/docs/SUMMARY.md b/docs/SUMMARY.md index 29f0afc..7abe472 100644 --- a/docs/SUMMARY.md +++ b/docs/SUMMARY.md @@ -29,7 +29,8 @@ * [Best practices](hosting-a-server-with-northstar/dedicated-server/best-practices.md) * [Hosting on Linux](hosting-a-server-with-northstar/dedicated-server/hosting-on-linux.md) * [Troubleshooting](hosting-a-server-with-northstar/troubleshooting.md) -* [Guides](hosting-a-server-with-northstar/hosting-guides.md) +* [Guides](hosting-a-server-with-northstar/guides/README.md) + * [Docker Install](hosting-a-server-with-northstar/guides/pg9182-docker-installation-guide.md) ## Modding and Development diff --git a/docs/hosting-a-server-with-northstar/guides/README.md b/docs/hosting-a-server-with-northstar/guides/README.md new file mode 100644 index 0000000..5827861 --- /dev/null +++ b/docs/hosting-a-server-with-northstar/guides/README.md @@ -0,0 +1,12 @@ +--- +description: Guides to setting up a server +--- + +# Guides + +{% hint style="info" %} +Note that these guides might not fully reflect best practices and can be outdated. However they should be helpful in setting up a server for the first time.\ +If you're planning to get serious about hosting your own server, please check out the ["Hosting a Dedicated Server" section](dedicated-server/). +{% endhint %} + +{% embed url="https://www.youtube.com/watch?v=EZ3w2Nl9SZo" %} diff --git a/docs/hosting-a-server-with-northstar/guides/pg9182-docker-installation-guide.md b/docs/hosting-a-server-with-northstar/guides/pg9182-docker-installation-guide.md new file mode 100644 index 0000000..ebd61b2 --- /dev/null +++ b/docs/hosting-a-server-with-northstar/guides/pg9182-docker-installation-guide.md @@ -0,0 +1,88 @@ +--- +description: pg9182 has provided a complete docker image to run on Linux servers. This provides some server management tools and offers better performance. No physical GPU is needed. His github page can be found [here](https://github.com/pg9182/northstar-dedicated) This page is to provide basic instructions, more information and config options are found at pg9182's github. +--- + +The aim of this guide is to show the steps to build a docker-compose container that starts on boot and to show basic configuration + +## Prerequisites + +| Requirement | Description +| ------------------| ---------------------------------------------------------| +| Kernel | Linux 5.3+, but 4.9+ should work | +| CPU | x86_64, at least 3 cores minimum | +| RAM | 2GB (Typically peaks at 1.6GB) | +| Disk | 5GB | +| Network | Recommended at least 7-20Mbps up | +| Docker | Have Docker and Docker-compose installed on the machine | + + +## Installation + +### Prep Titanfall Server files +You will need to copy over your Titanfall installation folder and place it on the Linux machine. Most of these files are for SP and therefore we can delete from the installation folder and prune the file size down to ~5GB. + +Easiest way to do this is copy the entire Titanfall2 folder to your desktop and delete the [following files](https://github.com/pg9182/northstar-dedicated#reducing-the-size-). + +### Copy Titanfall Folder over to the Linux Machine + +1. Access the files on your Linux machine using tools like [Filezilla](https://filezilla-project.org/) or [WinSCP](https://winscp.net/eng/download.php) +2. Navigate to `/mnt/Titanfall` (create directory if does not exist) +3. Copy the newly pruned Titanfall folder to the server. + +![/mnt/Titanfall/](https://i.postimg.cc/15HbbzFr/image.pnghttps://i.postimg.cc/15HbbzFr/image.png) + +### Copy mods to /mnt/mods +If you have configured some mods,these can be placed at '/mnt/mods` like below +![/mnt/mods](https://i.postimg.cc/tRD5jnrJ/image.png) + +### Create docker-compose file +We are going to be using Docker-Compose to set up our container, this gives us much more flexibility and allows us to make changes to the start up args much cleaner. + ``` + mkdir Titanfall + nano docker-compose.yml + ``` + + Example docker-compose.yml + + ```yaml + version: '3' + services: + northstar1: + image: ghcr.io/pg9182/northstar-dedicated:1-tf2.0.11.0 + pull_policy: always + environment: + - NS_PORT=37015 + - NS_PORT_AUTH=8081 + - 'NS_SERVER_NAME=[Region]Enter Server Name here' + - 'NS_SERVER_DESC=Enter your description here' + - | + NS_EXTRA_ARGUMENTS= + +setplaylist aitdm + +mp_gamemode aitdm + +map mp_angel_city + +ns_private_match_countdown_length 0 + +ns_should_return_to_lobby 0 + +net_compresspackets_minsize 64 + +net_compresspackets 1 + +spewlog_enable 0 + +sv_maxrate 127000 + volumes: + - /mnt/Titanfall:/mnt/Titanfall:ro + - /mnt/mods:/mnt/mods:ro + ports: + - '37015:37015/udp' + - '8081:8081/tcp' + restart: always + ``` + A list of all the CONVARs are [here](../../basic-listen-server#server-configuration) + + ## Starting + +### Run the following command + + To run this container type + ``` + docker-compose up + ``` + + diff --git a/docs/hosting-a-server-with-northstar/hosting-guides.md b/docs/hosting-a-server-with-northstar/hosting-guides.md deleted file mode 100644 index 5827861..0000000 --- a/docs/hosting-a-server-with-northstar/hosting-guides.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -description: Guides to setting up a server ---- - -# Guides - -{% hint style="info" %} -Note that these guides might not fully reflect best practices and can be outdated. However they should be helpful in setting up a server for the first time.\ -If you're planning to get serious about hosting your own server, please check out the ["Hosting a Dedicated Server" section](dedicated-server/). -{% endhint %} - -{% embed url="https://www.youtube.com/watch?v=EZ3w2Nl9SZo" %} -- cgit v1.2.3