After purchasing your SPX Solo, follow these steps to ensure a clean and working installation. ### 1. Download Download the version best suited for your operating system. > [!TIP] Get the official SPX Graphics Controller from the [SPX Graphics website](https://spxgraphics.com/software). ### 2. Extract the Zip File After downloading the release zip, extract it. You will find a folder containing the application binary: - **macOS & Linux:** `spx-server` - **Windows:** `spx-server.exe` Make sure the executable/binary is in the same directory as the `ASSETS` and `DATAROOT` folders. ### 3. Installation & Running #### Linux ```bash chmod +x spx-server-linux-x64 ./spx-server-linux-x64 ``` Follow any prompts to complete configuration. After setup, the application will display your HOST-ID, which is required for licensing. #### macOS Open the folder in Finder. Right-click inside the folder and select **New Terminal at Folder**. Then run: ```bash ./spx-server ``` You will be prompted for user access configuration — select Yes or No. After setup, the application will display your HOST-ID, which is required for licensing. #### Windows Open the folder containing `spx-server-windows.exe`. Run the application by double-clicking it or from the Command Prompt: ```cmd spx-server-windows.exe ``` Follow the prompts to complete the user access configuration. Your HOST-ID will be displayed after setup for licensing purposes. ### 4. First launch On first launch, SPX generates a [[Documentation/Server/Configurations|config.json]] file with default values along with `LOG` and `DATAROOT` folders in the installation directory. A browser window opens automatically with the SPX interface, typically at `http://127.0.0.1:5656`. See [[Guides/Getting Started/First Launch|First Launch]] for a walkthrough of the initial setup. ### Common Errors #### Port in use: If SPX fails to start with `Error: listen EADDRINUSE: address already in use`, another application is already using that port. Open `config.json` in a text editor, change the `general.port` value to a different port (e.g. `5657`), save, and relaunch. #### Bad CPU type in executable (M1/M2 Mac): On Apple Silicon Macs, you may see *"bad cpu type in executable"*. Fix this by running Terminal with Rosetta: right-click Terminal → Get Info → check **Open using Rosetta**, then launch SPX from that Terminal session. #### File not executable (Mac and Linux): On macOS and Linux, the operating system may not treat the downloaded file as an executable. Open a terminal, navigate to the extracted folder, and run: ```bash # Linux sudo chmod +x ./SPX_linux64 # macOS sudo chmod +x ./SPX_macos64 ``` #### macOS "App is damaged" error: Some Mac users encounter *"App is damaged and can't be opened. You should move it to the Trash."* This is caused by macOS adding an extended attribute to the file. Remove it with `xattr` in the Terminal: ```bash xattr -cr ./SPX_macos64 ``` #### macOS wrong folder issue: On some Mac systems, generated files may appear in the user's home directory instead of the application directory. If this happens, navigate to the installation folder in a Terminal first, or use the full path to the executable. --- ## SPX Launcher SPX Launcher is a desktop application for launching and managing SPX Graphics Controller directly from your desktop. - Start and stop the SPX server - View server status and logs - Quick access to the SPX web interface --- ## SPX Installer SPX Installer is a desktop application that provides a graphical interface for installing your SPX Graphics Controller. ---