Site Tools


dev:setup_guide

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
dev:setup_guide [2024/06/25 18:19] – [Running the Generator from the Command Line] wylemdev:setup_guide [2024/08/22 07:01] (current) – [Initial Requirements] Microsoft ruins everything wylem
Line 1: Line 1:
 ====== Setting up the FF4FE generator ====== ====== Setting up the FF4FE generator ======
 ===== Initial Requirements ===== ===== Initial Requirements =====
 +  - Install Python, if it's not already installed
 +    * Versions 3.7 through 3.11 are supported, but 3.11 is recommended for performance reasons((Python 3.12 will likely remain incompatible until FE 5.0 or later))
   - Clone the FF4FE repo - [[https://github.com/HungryTenor/FreeEnterprise4]]   - Clone the FF4FE repo - [[https://github.com/HungryTenor/FreeEnterprise4]]
   - Set up site URLs and secrets in the ''.env'' file   - Set up site URLs and secrets in the ''.env'' file
     * ''EMBEDDED_REPORT_KEY'' must be 16, 24, or 32 bytes     * ''EMBEDDED_REPORT_KEY'' must be 16, 24, or 32 bytes
-  - Set up a Python ENV (from project root dir): ''python -m venv ENV'' +  - Set up a Python ENV (from project root dir) using your desired Python version: ''<path-to-python3.xx>\python -m venv ENV'' 
-    * Make sure to use the desired Python version for this+    * It's highly recommended that you use the full path to the Python executable to ensure you're running the intended version.
   - Create the file ''fe.pth'' at the specified location:   - Create the file ''fe.pth'' at the specified location:
     * Windows: ''ENV\Lib\site-packages\fe.pth''     * Windows: ''ENV\Lib\site-packages\fe.pth''
Line 30: Line 32:
     * Linux: https://www.mongodb.com/docs/manual/administration/install-on-linux/     * Linux: https://www.mongodb.com/docs/manual/administration/install-on-linux/
       * You may also need to run ''ulimit -n 64000'' to raise the limit on number of open files       * You may also need to run ''ulimit -n 64000'' to raise the limit on number of open files
-  - Download Floating IPS and extract the appropriate executable to ''FreeEnt/server/bin/'' (the directory will need to be created) +  - Download [[https://github.com/Alcaro/Flips/releases|Floating IPS]] and extract the appropriate executable to ''FreeEnt/server/bin/'' (the directory will need to be created) 
-    * Windows and Mac: [[https://www.romhacking.net/utilities/1040/]] +    * For Linux, set the executable bit (''chmod +x'') on the flips-linux executable 
-    * Linux: The code can be found at [[https://github.com/Alcaro/Flips]] +    * For a headless Linux setup, you may need to compile the [[https://github.com/Alcaro/Flips/|source]] yourself
-      * Set the executable bit (''chmod +x'') on the flips-linux executable+
  
 ===== Running the Web Server ===== ===== Running the Web Server =====
dev/setup_guide.1719339555.txt.gz · Last modified: 2024/06/25 18:19 by wylem