-
Notifications
You must be signed in to change notification settings - Fork 10
developer vm
This guide describes the setup of a Ubuntu VM for YIO Remote development.
Host system:
- Dual core processor or better.
- 8 GB RAM or more recommended.
- 50 GB of free hard drive space.
SSD is highly recommended. - Internet access.
Software:
A virtualization software is required if the Linux system is not installed on a dedicated PC or as dual boot option.
Recommendations:
-
Oracle VM VirtualBox
A cross-platform virtualization application and free for personal use. - VMware Fusion / Player / Workstation
A commercial alternative with usually better desktop integration. - Windows Hyper-V
Included in Windows 10 Pro, but can only be used if no other virtualization software is in use!
Other virtualization software will work too of course. We just list what we are using personally.
The minimal recommended Ubuntu version is 18.04 LTS.
Versions 19.04 and 19.10 have been tested as well. If you want long term support without the latest features and software versions then choose the LTS version.
At the time of writing this guide the only fully working Ubuntu version with Windows Hyper-V was the provided 18.04.3 LTS version within Hyper-V. The newer 19.04 was not working with the advanced features like custom resolution!
Download the desired Ubuntu Desktop ISO image from https://ubuntu.com/download/desktop.
This guide will use the 19.10 version with VMware Fusion.
Create a new virtual machine from the downloaded ISO image.
-
In VMware select "Install from disc or image" and the creation wizard starts:

-
When using VMWare you can choose "Linux Easy Install" to automatically create a user account during installation.
For this guide we are not using it to show the regular setup process applicable for installations with other virtualization software.
-
In the firmware type page use the default "Legacy BIOS" option:

-
In the final wizard step click "Customize" and give a better name to the virtual machine like "YIO Development":

The creation wizard is now complete.
Before starting the new VM some settings should be customized though:
- Processor cores: at least 2
- Memory: at least 4 GB

- Disk space: at least 50 GB

The virtual machine can now be started for the Ubuntu OS installation.
Start the virtual machine to begin the installation process.
-
Choose your preferred language and click 'Install Ubuntu':

-
Choose your keyboard layout and click 'Continue':

-
Since we like the development as small as possible select minimal installation:

-
Use the default for installation type (hard drive partitioning):

-
Select timezone. With a network connection this is usually pre-selected to the correct location:

-
Set the user account information

-
Finish the installation with 'Restart Now' and press Enter when asked to eject the installation medium.

-
After system reboot you are greeted by the login screen.
Select your account, enter your credentials defined in the setup process.
-
At first login a setup wizard is shown.
Select desired options or skip through the wizard:
-
Software updates might be available. Install the updates and restart system if asked to.
The installation of the base Linux system is now finished! Next step is to install the required development tools.
This topic is currently being created and worked on!
YIO Remote Project Documentation Wiki Page https://github.com/YIO-Remote/documentation/wiki
Home
YIO Remote API
Dock
FAQ
Supporters
Remote Firmware
Dock Firmware
YIO Homepage
YIO Community
YIO Github
YIO Discord Channel
YIO Facebook
YIO Instagram
YIO Twitter
YIO YouTube
YIO Translation
Dock
Remote
Supported IR Extenders
Home Assistant
Homey
openHAB
Roon
Spotify
YIO Dock
Build Environment
Setup Qt IDE
Setup PlatformIO IDE
Developer VM
Setup Buildroot
API
API
WebSocket API
Generic
SSH/SCP
Architecture
Coding Guidelines
Configuration File
Developing Integrations
Entity Types
Logging
Workflow
Git Workflow
Pull Requests
Continuous Integration