Prepare your device and run an App from the Marketplace

Pantavisor Linux comes installed with Pantabox that allows you to configure, install and update your apps, the kernel and even the Pantavisor itself. This guide describes how to flash and boot an embedded device with Pantavisor Linux and run Pantabox. You’ll then download and install the Home Assistant, an open source home automation platform from the Pantacor One Marketplace and display it in your browser.

After completing this guide, you may want to try Configuring and Installing Apps from Docker Hub where we dive a little deeper and describe how to use configuration overlays and a number of other features of Pantavisor Linux.

Sections in this guide:

Before you begin

You’ll need to have available:

  • An Internet connection
  • A laptop and a microSD card

Download and install Pantavisor Linux

1. Download the base Pantavisor image.

Select the platform and architecture that matches your device and download the image.

2. Prepare the device.

Flash the microSD card with the downloaded bootable image. If you haven’t done this before, refer to these instructions:

3. Boot device with Pantavisor Linux image.

Insert the microSD card into the device, ensure that it is connected to the network and then boot with the image. This procedure may differ depending on your platform:

4. Connect device to the Internet

Devices can be connected to the Internet either through a WiFi captive or directly with an ethernet cable. For details on how to do that for your platform see Setting up an Internet Connection

5. Login with user: root and password: pantabox.

After booting the device, if a monitor and keyboard is attached, you will see the Pantavisor Linux logo with some default instructions on how to login.

How to ssh on to the device

You can directly login to the device if you have a keyboard and monitor attached to it. But the more convenient way is to ssh on it:

ssh root@[device-ip]

You can find the IP address of you device in the upper right hand corner after you’ve logged in. Login with the default pantabox password. (Setup your public key with the edit-sshkeys commands.)

If you don’t have a keyboard and monitor attached to log in and view the device’s IP, then please download the Pantavisor command line interface or pvr cli onto your laptop. Afterwards scan the network with:

pvr device scan

Note the IP address for your device and use that to ssh.

Important! Before going into production, please remember to change the default login with the chpasswd command.

6. Display the menu with the pantabox command.

pantabox menu

Install Home Assistant from Pantacor One Marketplace

Now you’re ready to install Home Assistant (an open source, privacy first Home Automation platform):

1. Navigate to the Pantacor One Marketplace.

Display the pantabox menu with pantabox and then select install. Choose Pantacor One Marketplace:

install app pantabox

2. Select Home Assistant from the list of available apps and press OK.
3. View the app.

Once the app is finished installing, run pantabox and select View:

install app pantabox

4. Locate the default port for Home Assistant.

To locate the port setting for Home Assistant, type pantabox and then select edit from the menu. The Interactive Shell appear, where you can use vi or nano to view the app manifest:

vi homeassistant/v0alpha.app.manifest.json
5. Add and commit your changes before exiting the shell.

This creates a local device revision that includes the newly installed Home Assistant app.

pvr add .
pvr commit

Apply your changes with:

exit 0
6. Display the Admin dashboard.

Finish setting up Home Assistant by pointing your browser at the IP address of the device (located in the right hand corner of your screen) with the port specified in the app manifest:

Home Assistant admin screen

See Also:

Questions or Comments? Join the Pantavisor Slack community

Have any questions or comments? Please join our Slack community at http://pantavisor.slack.com.