aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorAndrew Lee <andrew@alee14.me>2025-05-04 16:52:02 -0400
committerAndrew Lee <andrew@alee14.me>2025-05-04 16:52:02 -0400
commit168d7238f68c0b0b6547eab367043743ba403583 (patch)
treed1939e488553e19ed288c792057dcab961e6e637 /README.md
parent0d4bf01b8568f38454f16e8f1de1e31751afa652 (diff)
downloadfreeso-docker-168d7238f68c0b0b6547eab367043743ba403583.tar.gz
freeso-docker-168d7238f68c0b0b6547eab367043743ba403583.tar.bz2
freeso-docker-168d7238f68c0b0b6547eab367043743ba403583.zip
README; Generate random root password
Diffstat (limited to 'README.md')
-rw-r--r--README.md25
1 files changed, 25 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..8c08848
--- /dev/null
+++ b/README.md
@@ -0,0 +1,25 @@
+# FreeSO Docker
+Running a FreeSO server on a Docker compose stack.
+
+Note: This will **not** be support for FreeSO itself, report any problems on the official repo.
+
+# Requirements
+- Linux x64 server or WSL (not tested)
+- Basic understanding on Linux
+
+# How to run
+1. First create directories (auth, game, nfs, vars).
+2. Copy config.sample.json to config.json.
+3. Create an .env file with the following content:
+```
+DB_USERNAME=fsoserver
+DB_PASSWORD=[password]
+DB_NAME=fso
+```
+4. Download or compile the FreeSO server. If downloaded, extract the content to the server subdirectory. If compiled, rename the output directory as FreeSOServer.
+5. Put it in a subdirectory as FreeSOServer. (ex. server/FreeSOServer)
+6. Create a docker image for the FreeSO server by doing `docker build . -t freeso` on the server subdirectory.
+7. Download and extract TSO files on the `game` folder.
+8. Change the server for the database ip to `db` as it will connect to the mariadb container.
+9. Follow the [guide](https://github.com/riperiperi/FreeSO/blob/master/Documentation/Initial%20Setup.md) from the FreeSO repo.
+10. Run the server as `docker compose up -d`.