FAQ

What is HypriotOS?

See this description here.

On which boards can HypriotOS run?

Is there an easy way to flash the image of HypriotOS onto a SD card?

Yes, check out our flash tool, which makes the flashing process super easy and fast.

Default Credentials

The default credentials for the image are user pirate with password hypriot.

Connection via SSH to a fresh HypriotOS, I get connection reset by peer.

After all, Re-flashing of the SD cards is all that we’ve experienced as a solution for this error.

How can I change the hostname?

Starting with HypriotOS 1.7 we use cloud-init to automatically change some settings on first boot.

Just edit the /boot/user-data file with an editor before you flash the SD image.

sudo nano /boot/user-data

and change the line with hostname:

hostname: black-pearl

At the first boot the device comes up with the new hostname. See more details about the user-data file in the blog post Bootstrapping a Cloud with Cloud-Init and HypriotOS. After the first boot you can change the hostname as usual on any Linux box.

See also our sample cloud-init configuration files for more inspiration.

How can I boot a Raspberry Pi Zero?

To configure and boot a Raspberry Pi Zero without a mini HDMI adapter you can prepare everything before the first boot.

Run our flash script with the following options to have a wireless out-of-the-box experience on first boot.

flash --userdata wifi.yaml hypriotos-rpi-v1.10.0.img.zip

You can also use the --hostname option to adjust the hostname per flash command without changing your wifi.yml template. This is super convenient if you want to flash a whole cluster of Raspberry Pi’s.

wifi.yaml

#cloud-config

# Set your hostname here, the manage_etc_hosts will update the hosts file entries as well
hostname: black-pearl
manage_etc_hosts: true

# You could modify this for your own user information
users:
  - name: pirate
    gecos: "Hypriot Pirate"
    sudo: ALL=(ALL) NOPASSWD:ALL
    shell: /bin/bash
    groups: users,docker,video
    plain_text_passwd: hypriot
    lock_passwd: false
    ssh_pwauth: true
    chpasswd: { expire: false }

package_upgrade: false

# # WiFi connect to HotSpot
# # - use `wpa_passphrase SSID PASSWORD` to encrypt the psk
write_files:
  - content: |
      allow-hotplug wlan0
      iface wlan0 inet dhcp
      wpa-conf /etc/wpa_supplicant/wpa_supplicant.conf
      iface default inet dhcp
    path: /etc/network/interfaces.d/wlan0
  - content: |
      country=de
      ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
      update_config=1
      network={
      ssid="your-ssid"
      psk="your-preshared-key"
      proto=RSN
      key_mgmt=WPA-PSK
      pairwise=CCMP
      auth_alg=OPEN
      }
    path: /etc/wpa_supplicant/wpa_supplicant.conf

# These commands will be ran once on first boot only
runcmd:
  # Pickup the hostname changes
  - 'systemctl restart avahi-daemon'

  # Activate WiFi interface
  - 'ifup wlan0'

Please note, that you can either use your WiFi password directly or encrypted with wpa_passphrase. If you use the plain password use quotes around your password (e.g psk="s3cr3t"), if you use an encrypted key you have to use it without quotes (e.g. psk=1acd324e...).

Adjust the line with country= to your country code.

After turning on your Raspberry Pi Zero it should be connected to your WiFi and reachable at black-pearl.local (or your hostname of choice).


You think that some important information is missing? Improve this site on GitHub!