Skip to content

Instantly share code, notes, and snippets.

Embed
What would you like to do?
openBalena VPS Configuration

Locally installing to a server

Pre-requisites

# /etc/systemd/system/docker.service.d/override.conf
[Service]
ExecStart=
ExecStart=/usr/bin/dockerd -H fd:// -H tcp://127.0.0.1:2376
$ sudo systemctl daemon-reload
$ sudo systemctl restart docker.service
  • Install docker-compose: https://docs.docker.com/compose/install/
  • Setup DNS entries:
    • A record “openbalena.{domain}” to the server IP address
    • CNAME record “*.openbalena.{domain}” to “openbalena.{domain}”
    • Setup any firewalls:
    • Allow ports 80, 443, 3128 to the server

Basic tests

  • $ dig *.openbalena.{domain} to check DNS
  • Workstation can ping “openbalena.{domain}”
  • Workstation can ping “test.openbalena.{domain}”

Workstation has balena tools installed:

  • Balena-CLI
  • Etcher
  • Docker

Optional:

  • $ export DOCKER_HOST=tcp://127.0.0.1:2376
  • $ docker ps

Installing openBalena

  • Clone the repository: git clone https://github.com/balena-io/open-balena.git
  • Setup openBalena:
./scripts/quickstart \
-U <email@address> \
-P <password> \
-d openbalena.<domain.com> \
-c
  • Start openBalena: ./scripts/compose up -d

  • Point balena-cli to openBalena: export BALENARC_BALENA_URL=openbalena.<domain.com>

  • Create a new app: balena app create testApp

  • Download the balenaOS from here and configure the image to use your app: balena os configure ~/path/to/balenaOS.img --app testApp

  • Flash the SD Card: balena local flash ~/path/to/balenaOS.img

  • Deploy balena project to the device: balena deploy testApp --emulated --logs --build

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
You can’t perform that action at this time.