Prerequisites

• A ssh key. You should have an ssh key that was added to your account, we’ll use that from now on when connecting.
• A wireguard config. You should be given this file.
• A devserver IP

Wireguard

SSH Config

Since our ssh is here, but we’re going to be cloning from github, lets set up ssh to forward our key agent. Add the following to your ssh config ~/.ssh/config

Host devserver
  HostName <<YOUR DEVSERVER IP>>
  User <<YOUR USERNAME>>
  ForwardAgent yes

Repository

Before we can connect to a running set of the code, we need the code to be on the devserver (hopefully this is automated soon). Lets clone the repo, then allow direnv to work in that repository.

ssh devserver
git clone git@github.com:batteries-included/main.git
cd main
direnv allow

That last direnv allow should take a while. It compiles all of the dependencies for the cli, the control server, the home server, and example projects.

VSCode

First add the Remote SSH extension

For example running the following in vscode: ext install ms-vscode-remote.remote-ssh

Success

Everything should be able to be connected now. Open Vscode Choose the Remote Explore tab on the left. devserver should be an option there, and the main repo should be selectable.

You can continue with the Developing section from the readme, by running bix bootstrap in one shell, and after everything’s ready bix dev in another server.