Before you start: install and start Docker Desktop. You will also need an internet connection and an SPX account. You do not need to write code or install Python manually with the native Windows/macOS packages.
Install with SPX Setup — recommended
1. Get your product key
Create an SPX account and confirm your email. Sign in, open Product Keys and choose Reveal key, then Copy key. You will paste this key into SPX Setup. If no key is listed, activate a plan in Billing first.
For non-commercial evaluation, Community is free and needs no payment card.
2. Download the installer
Open Downloads, leave Stable selected and choose Windows (.exe) or macOS (.pkg).
3. Run SPX Setup
Run the downloaded file and open SPX Setup (it opens automatically after installation on macOS).
- Keep Interactive (default) selected and choose a local installation.
- Select your packages or protocols and keep SPX UI enabled.
- Paste your product key when asked, then choose to start SPX now.
Setup prepares and starts the required Docker services for you. The first run downloads components, so waiting time depends on your connection.
4. Open SPX
When setup finishes, your browser opens SPX. If it does not, open http://localhost:3000. In Settings, Ready and Authorization: Accepted by SPX server confirm the connection. Keep Docker Desktop running while you use SPX.
Installation complete. Continue with First device in the UI to run a temperature sensor and check its 31.25°C readback.
Install with an AI agent — optional
Install with an AI agent
Prefer a conversation? Use your own local AI agent with project MCP support. SPX Setup prepares its working folder for you.
1. Get the installer and your key
Get your product key and download the Stable installer. Keep Docker Desktop running.
2. Choose Agent Setup
Open SPX Setup and select Configure with your own AI Agent. Enter your product key in Setup when asked. Setup shows the folder to open in your agent; keep the key out of the chat.
3. Describe what you need
Open that folder in your local agent and say “Complete SPX setup and installation.” Describe your devices or protocols. Ask to include SPX UI and start SPX now. The agent proposes a configuration for you to review.
4. Approve and open SPX
Approve the plan in the conversation. Wait for the agent to confirm that installation and startup have succeeded, then open the UI address it reports (normally http://localhost:3000). Check Settings → Ready and Authorization: Accepted by SPX server.
Ready for your first device? Continue in the same agent conversation to create a simulation, or follow First device in the UI. Installation does not create simulation instances automatically.
Supported versions and more help
For Linux, upgrades, API checks or troubleshooting, use the detailed Installation Guide. Before replacing an existing installation, export its configuration or save a disk snapshot. Setup asks before replacing an existing stack; keep it if you do not intend to replace it.
Agent Setup prepares the local workspace used for installation and later simulation work. For other MCP clients or connection troubleshooting, see Connect your MCP client.
Workspace members should ask an owner or admin for their product key. Keep it private. For uninstall instructions and platform details, use the Installation Guide.