Add Your First Device To the Project

Once your project is created, you can add a device to it.

Option A: Virtual Device (No Hardware Needed)

Virtual devices are a quick way to explore IronFlock without physical hardware. They are a paid feature.

1. Open your project and click NEW DEVICE.
2. Select Virtual device.
3. Enter a device name and click CREATE DEVICE.

The virtual device starts automatically and appears online in your project within seconds.

Option B: Physical Device (e.g. Raspberry Pi)

1. Open your project and click NEW DEVICE.
2. Select Flash with FlockOS and choose the hardware architecture.
3. Enter a device name and click CREATE DEVICE — this downloads a .flock configuration file.
4. Open FlockFlasher, load the .flock file, and flash an SD card.
5. Insert the SD card into your device, connect it to the internet, and power it on.

The device should appear online within a few minutes.

For other connection methods (USB installer, custom Linux installation, Windows), see Connect Devices.

Verify the Connection

Open Project Settings → Devices to see all devices in your project. Each device shows a status icon indicating whether it is online. Click on a device to see its name, architecture, and connectivity status.

Add the Device to an App

To use a device with an app, you need to add the device to a specific app.

1. In your project, open Settings.
2. Scroll down to find the installed app and open its App Settings.
3. Click Add Device and select the device(s) you want to deploy the edge component to.
4. If the device is online, the edge component downloads to the device and starts automatically.

You can add or remove devices from an app at any time, and you can assign the same app to multiple devices or device groups within your project.

Manage the App

From the device’s app panel, you can:

• Start / Stop the edge component on that device using the status controls.
• View Live Logs — Click the settings icon on an app, then select Live Logs to see real-time output from the edge component.
• Configure Parameters — Some apps expose user-configurable parameters (like recording intervals or thresholds). Adjust these in the app settings.
• Configure Remote Access — Set up remote access to the app’s edge component on this device. See Remote Access for details.

For more details, see Using Apps.

What’s Next?

From here, explore:

• Using Apps — Boards, parameters, and app management
• AI Features — How AI agents work within apps
• Developing Apps — Build your own IoT apps
• Devices — Device management and groups