Network Access

Before removing the serial console or HDMI monitor and USB keyboard, verify network connectivity. The provided images default to obtaining network settings from a DHCP server.

Verify Network Configuration

Determine your IP address:

$ ip addr

Check that you have a default gateway:

$ ip route

Ping a known host:

$ ping -c3 iot.fedoraproject.org
The sample above requires name resolution and a route to the internet. If your device is located on an isolated network, ping another host on your network.

Verify that sshd is running:

$ systemctl is-active sshd

View the default firewall configuration:

$ sudo firewall-cmd --list-all
Information on adding support for specific devices can be found in the User Guide.

Configure Remote Access

Once the initial setup is complete, the serial console or HDMI monitor and USB keyboard are no longer required to access the device. The device can be left in a headless state and accessed remotely.

The released images are configured to run an SSH server and accept outside connections. The default configuration allows root login if a password is set. This is a good reason to leave the root account locked. The default configuration also allows standard users to login and the user can then sudo if they were made an administrator as a member of the wheel group.

$ ssh testuser@11.22.33.44
Authentication Failures

If receive a "Too many authentication failures" message such as:

Received disconnect from 11.22.33.44 port 22:2: Too many authentication failures

you may have too many different ssh keys in your personal ssh configuration directory. Since the image does not have your key, try connecting with a password first using:

$ ssh -o PreferredAuthentications=password testuser@11.22.33.44

If this works, you can customize your ssh configuration to specify either this option or options to use a specific key once you have added your keys.
More information on managing accounts, keys, and remote access can be found in the User Guide.

Want to help? Learn how to contribute to Fedora Docs ›