If something isn’t working, start here
Most issues come down to connection or setup. Keep it simple. If Companion can see your device and trigger a basic action, everything else will work.
Companion not loading
• Open Companion in your browser at 127.0.0.1:8000
• If that doesn’t work, use your computer’s IP address (e.g. 192.168.1.100:8000)
• Restart Companion
• Try a different browser
Device not responding (ATEM, PTZ, etc.)
• Confirm the device is powered on
• Confirm the device and computer are on the same network
• Check the IP address in Companion matches the device
• Confirm the correct module and model are selected
• Check connection status in Companion
If Companion cannot connect to the device, buttons will not work.
Buttons visible but not working
• Check that the device connection is configured correctly
• Confirm IP address and model selection
• Try a simple test action (e.g. switch input)
• Re-import using Full Import if unsure
Stream Deck not showing
• Quit the Elgato Stream Deck software
• Go to Surfaces → Rescan USB
• Go to Settings → Surfaces, enable “Enable direct connection to Streamdecks. When disabled support for the Elgato software Plugin will be enabled”
• Use a Surface Emulator if needed
Layout looks incorrect
• Go to Settings → Buttons
• Disable Show topbar on each button
If enabled, buttons will appear compressed, misaligned, and text will be missing.
Import issues
• Confirm you are using Companion 4.2.6 or later
• Use Full Import for a clean setup
• Ensure all components are selected during import
Variable or automation errors
• Usually caused by undefined variables or incomplete setup
• Re-import using Full Import to reset the system
• Advanced users: check that required variables are initialized
Raspberry Pi issues
• Use wired Ethernet instead of WiFi
• Allow time after boot for network to initialize
• Restart Companion if connections fail
Something worked before, now it doesn’t
• Check if the device IP address has changed
• Restart the device and Companion
• Confirm network connections are still active
Using static or reserved IP addresses is recommended.
Reset to a known working state
If you are unsure where the issue is:
• Confirm Companion is running
• Confirm the device appears in Connections
• Trigger a simple action manually
If that works, the system is functioning correctly.
Need help?
If you want to move faster or avoid trial-and-error:
• Book a 1:1 session for setup or troubleshooting
• Bring your system live and resolve issues in real time
This is the fastest way to get fully operational.
