Difference between revisions of "Development:Configuring FEX"
Jump to navigation
Jump to search
(Created page with "== FEXConfig configuration == '''To be filled''' * File-> Load Default Options ** Only do this one time to fill the default Config.json ** File-> Save to save this to .fex-emu...") |
|||
(2 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
− | == FEXConfig configuration == | + | == Configuration via GUI == |
− | ''' | + | |
− | + | The FEXConfig tool provides a graphical user interface to edit FEX configuration. On first use, it will load default settings and save them to .fex-emu/Config.json. | |
− | + | ||
− | * | + | === Setup Rootfs === |
− | * | + | The ''General'' tab in FEXConfig contains the rootfs configuration. |
− | ** | + | * Named RootFS folders option shows RootFS installed in '''$HOME/.fex-emu/RootFS/''' |
+ | ** sqsh files and folders are selectable here | ||
+ | * Selecting an option in the Named RootFS option will set the name in RootFS | ||
+ | ** If your x86 RootFS is in an absolute folder elsewhere, you can place the absolute path in the RootFS option | ||
== Manual Configuration == | == Manual Configuration == | ||
Line 26: | Line 29: | ||
** Additionally each option has a "JSON key" name that shows the Key inside of the Config.json file | ** Additionally each option has a "JSON key" name that shows the Key inside of the Config.json file | ||
** Every option is a string inside of the config and will be reinterpreted to their programmatic type at load | ** Every option is a string inside of the config and will be reinterpreted to their programmatic type at load | ||
+ | |||
+ | [[Category:Development]] |
Latest revision as of 17:02, 16 February 2025
Configuration via GUI
The FEXConfig tool provides a graphical user interface to edit FEX configuration. On first use, it will load default settings and save them to .fex-emu/Config.json.
Setup Rootfs
The General tab in FEXConfig contains the rootfs configuration.
- Named RootFS folders option shows RootFS installed in $HOME/.fex-emu/RootFS/
- sqsh files and folders are selectable here
- Selecting an option in the Named RootFS option will set the name in RootFS
- If your x86 RootFS is in an absolute folder elsewhere, you can place the absolute path in the RootFS option
Manual Configuration
The FEX main configuration file lives at $HOME/.fex-emu/Config.json
- or $XDG_CONFIG_HOME/.fex-emu/Config.json if you use XDG).
This is a JSON file that holds all of our settings. The basic structure is as follows:
{ "Config": { "Threads": "0", "MaxInst": "500", "RootFS": "Ubuntu_21_10" } }
There are a fair number of configuration options to tinker with. You can see a full suite of configuration option in the FEX man pages.
- man FEX - To see the options
- Under the ENVIRONMENT section there is each option's ENVIRONMENT override
- Additionally each option has a "JSON key" name that shows the Key inside of the Config.json file
- Every option is a string inside of the config and will be reinterpreted to their programmatic type at load