• Documentation
  • Release Notes
  • Forum
  • Motorcortex.io
  • Documentation
    • Getting started
      • Set up a controller
        • Install MCX-RTOS
          • Download
          • Install
            • Industrial PC
            • Raspberry Pi
            • Virtual machine
        • Use a cloud machine
      • Connect your PC
        • Configure your network
        • Install a browser certificate
        • Connection troubleshooting
      • Deploy an application
      • Play
        • Use Motorcortex Desk
        • Create a GUI
    • Standard Applications
      • Configure your application
        • Definitions
        • EtherCAT devices
          • CiA402 drives
        • Drive logic
        • Axes control
          • Transformations
          • Limiter
          • Window detectors
          • Controllers
            • Tune the controllers
        • Set up a robot
          • Kinematics and mass
          • Frames and tool offset
          • Joint jog limits
          • Manipulability
        • Set up a machine
        • Set up an AGV
        • Alarm devices
        • Add a 3D model
        • Final check
      • Motorcortex Machine App
        • Home
        • Axis Settings
        • Alarms
        • Safety
        • Diagnostics
      • Motorcortex Robot App
        • Definitions
        • Usage
          • User Interface
            • Home
            • Robot Data
            • Axis Settings
            • Alarms
            • Safety
            • Diagnostics
            • Axis Tuning
            • States, Modes and Events
          • Robot Settings
        • Robot Features
          • Additional Axes
          • Bartending
          • Belt Tracking
          • File Replay
          • Joysticks
          • SpaceMouse
          • UDP Communication
          • User Frames
          • Weaving Motion
        • API
    • Motorcortex Tools
      • Motorcortex.io
        • Portal Basics
        • Project packages
          • Binary package
          • Config Package
            • config.json
            • motorcortex.conf
            • control.xml
            • io/master.xml
            • mech/mech-parameters.xml
            • linking/*.link.json
            • udp/udp.packets.json
            • motionfiles
            • user/parameters.json
            • accounts.conf
            • license.lic
          • GRID Package
      • Motorcortex Desk
        • Workspace
        • Connecting
        • Exploring parameters
        • Plotting
        • Custom signals
        • Navigating the plot
        • Measuring
        • Analysing
        • Exporting
        • Replay
        • Settings
        • Keybindings
      • Motorcortex-ECAT
        • Top menu bar
        • Domains configuration panel
        • Device configuration panel
        • Simulating devices
        • Add a device
        • Custom SII firmware
        • How EtherCAT works in Motorcortex
        • Troubleshoot EtherCAT
      • Motorcortex-GRID
        • Top Menu Bar
        • Properties Panel
        • Screens
        • Widget library
        • 3D models
          • Models and objects
          • Animations
          • Trace lines
          • Camera, lights and rendering
        • Mapping values to text or images
    • Developing Client Applications
      • Python
        • Install
        • Usage
          • Fundamentals
          • Client app Tools
          • Robot Control
        • Tools and Examples
          • Hello world example
          • McxClientApp example - data logger
          • mcx-datalogger tool
          • Automated testing tools
        • API
      • C++
        • Install
        • Usage
          • Fundamentals
        • API
          • Request
          • Subscribe
      • JavaScript
        • Install
        • Usage
          • Fundamentals
        • API
      • Rust
        • Install
        • Usage
          • Fundamentals
        • API
      • Protocol Description
    • Developing Control Applications
      • Environment Setup
        • CLion
          • Cross Compilation
        • VS Code
      • Motorcortex Application Template
      • Control blocks
        • Control loops
          • ActuatorControlLoop
          • SimpleActuatorControlLoop
          • AxesControl
          • PID
          • PID_VariableGainControl
          • FeedforwardController
          • StateController
        • Limiters and shaping
          • Limiter
          • SoftLimiter
          • HardLimitVector
          • RateLimiter
          • RateLimiter3D
          • PVALimiter
          • PVALimiters
          • PvajLimiter
          • GainSchedulingPVALimiter
          • SmoothStop
          • Deadzone
          • Decay
        • Setpoints and motion
          • SetpointGenerator
          • SetpointGenerator4thOrder
          • Interpolator
          • MotionPlayer
          • Sequencer
          • SequenceSelector
          • Fader
        • Signal generation
          • SignalGenerator
          • SignalGenerators
          • MultiSine
        • Filters
          • LowPass1
          • LowPass2
          • HighPass1
          • HighPass2
          • BandPass1
          • FIRFilter
          • IIRFilter
          • MovingAverageFilter
        • Physical models and compensation
          • AdmittanceModel
          • ImpedanceModel
          • MassSpringDamperModel
          • FrictionCompensation
          • BacklashCompensation
          • Gearbox
          • Transformation
          • Transducer
          • TorqueSensorModule
        • Estimation and maths
          • Observer
          • ObserverKalmanFilter
          • StateSpace
          • Integrator
          • IntegratorRot3D
          • Polynomial
          • Lookup
          • Gain
          • SignalConverter
        • Switching and routing
          • ChannelSelector
          • ConfigurationSelector
          • SimpleSwitch
          • SimpleSwitch3D
          • SoftSwitch
          • LevelSwitch
          • FlipFlop
          • Delay
          • HostInModule
        • Detection and safety
          • CollisionDetector
          • MotionDetector
          • WindowDetector
          • AverageValueCheck
          • HomingSwitch
        • Migration notes
          • Migrating from 3.23.1 to 3.24.0 — `stictionFrictionForce = 0` users
      • Motorcortex Core API
        • Examples
        • Modules
          • Container
          • State_machine
          • Utils
    • Software Features
      • Cockpit
      • VS Code
      • Podman (Docker) Containers
    • Software Maintenance
      • Backup and Restore
      • Determine Image Version and Hardware Key
      • Remote access and file transfer
      • Default File Locations
      • Install License Key
      • Date and time
      • Network settings
      • Start/Stop/Restart
      • Simulation/Production Mode
      • Bridge-mode
      • Back-up and Restore Slave Configurations
    • Motorcortex Hardware
      • MCX A4
        • Bios Settings MCX A4
      • MCX A4+
        • Bios Settings MCX A4+
      • Virtual Machine full configuration
    • Frequently Asked Questions
    • Release Notes
  1. Documentation
  2. Getting started
  3. Set up a controller
  4. Install MCX-RTOS
Getting startedStep 1 of 4
  1. 1 Set up a controller
    1. Install MCX-RTOS
    2. Cloud machine
  2. 2 Connect your PC
  3. 3 Deploy an app
  4. 4 Play
Step 1: Set up a controller›Install MCX-RTOS

Install MCX-RTOS

Put MCX-RTOS, the operating system that runs Motorcortex, on an industrial PC, a Raspberry Pi or a virtual machine on your own PC.

  less than a minute  

You download the MCX-RTOS image that fits your controller from the motorcortex.io store, then install it in the way that controller needs. Click a box to open its guide.

Your controller What you download How you install it Install on an industrial PC Industrial PC Intel-based controller Download the Intel image and the imager stick image Intel image plus the imager stick image Install with the USB imager stick USB imager stick boot from it, then restore Install on a Raspberry Pi Raspberry Pi Raspberry Pi 4 Download the Raspberry Pi image Raspberry Pi image for the Raspberry Pi 4 Write the image to an SD card SD card with Raspberry Pi Imager Run MCX-RTOS in a virtual machine Virtual machine on your own PC Download the image for your virtual machine Intel disk image or .ova for QEMU or VirtualBox Start it in QEMU or VirtualBox QEMU or VirtualBox no hardware needed

Steps

  1. Download the image for your controller: Download.
  2. Install it: Install.

Next: Download the image.

© 2026 Vectioneer BV All Rights Reserved