2022-10-17 13:25:16 +00:00
|
|
|
# How to get Synit running on an emulated PostmarketOS device
|
|
|
|
|
|
|
|
|
|
[vouch.id]: https://vouch.id/
|
|
|
|
|
|
|
|
|
|
Begin by following the [generic PostmarketOS instructions for running using
|
|
|
|
|
QEMU](https://wiki.postmarketos.org/wiki/QEMU_amd64_(qemu-amd64)), reprised here briefly, and
|
|
|
|
|
then build and install the Synit packages and (optionally) the SqueakPhone user interface.
|
|
|
|
|
|
|
|
|
|
## Build and install `qemu-amd64` PostmarketOS
|
|
|
|
|
|
|
|
|
|
First, run `pmbootstrap init` (choose `qemu`, `amd64`, and a `console` UI); or, if you've done
|
|
|
|
|
that previously, run `pmbootstrap config device qemu-amd64`.
|
|
|
|
|
|
2022-10-17 19:06:01 +00:00
|
|
|
Then, run `pmbootstrap install` to build the rootfs.
|
|
|
|
|
|
|
|
|
|
Finally, run `pmbootstrap qemu --video 720x1440@60` to (create, if none has previously been
|
|
|
|
|
created, and) start an emulated PostmarketOS device. You'll run that same command each time you
|
|
|
|
|
boot up the machine, so create an alias or script for it, if you like.
|
2022-10-17 13:25:16 +00:00
|
|
|
|
|
|
|
|
## Set up `ssh` access to the emulated device
|
|
|
|
|
|
|
|
|
|
I have the following stanza in my `~/.ssh/config`:
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
Host pm-qemu
|
|
|
|
|
HostName localhost
|
|
|
|
|
Port 2222
|
|
|
|
|
User user
|
|
|
|
|
StrictHostKeyChecking no
|
|
|
|
|
UserKnownHostsFile /dev/null
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Log in to the device using a username and password (`SSH_AUTH_SOCK= ssh pm-qemu`) and set up
|
|
|
|
|
SSH key access via `~/.ssh/authorized_keys` on the device, however you like to do it. I use
|
|
|
|
|
[vouch.id][] to log into my machines using an SSH certificate, so I do the
|
|
|
|
|
following:
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
mkdir -p .local/bin
|
|
|
|
|
cd .local/bin
|
|
|
|
|
wget https://vouch.id/download/vouch
|
|
|
|
|
chmod a+x
|
|
|
|
|
sudo apk add python3
|
|
|
|
|
echo 'export VOUCH_ID_PRINCIPAL=tonyg@leastfixedpoint.com' >> ~/.profile
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Then I log out and back in again to pick up the `VOUCH_ID_PRINCIPAL` variable, followed by
|
|
|
|
|
running
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
vouch server setup --accept-principals tonyg
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
(Substitute your own preferred certificate principal username, of course.) After this, I can
|
|
|
|
|
use the [vouch.id][] app to authorize SSH logins.
|
|
|
|
|
|
|
|
|
|
## Allow port forwarding over SSH to the device
|
|
|
|
|
|
|
|
|
|
Edit `/etc/ssh/sshd_config` to have `AllowTcpForwarding yes`. This will let you use e.g.
|
|
|
|
|
port-forwarded VNC over your SSH connection to the device once you have the user interface set
|
|
|
|
|
up.
|
|
|
|
|
|
|
|
|
|
## Build and install the packages
|
|
|
|
|
|
|
|
|
|
Follow the [build and installation instructions](./install.md) to check out and build the code.
|
|
|
|
|
|
|
|
|
|
Once you've checked out the `synit` module and have all the necessary build dependencies
|
|
|
|
|
installed, change directory to `synit/packaging/squid` and run `start.sh` in one terminal
|
|
|
|
|
window. Leave this open for the remainder of the build process. Open another terminal, go to
|
|
|
|
|
`synit/packaging`, and run `make keyfile`. Then, run `make ARCH=x86_64`.
|
|
|
|
|
|
|
|
|
|
Hopefully the build will complete successfully. Once it has done so, change to `synit/scripts`
|
|
|
|
|
and run `./upload-bundle.sh pm-qemu`. Then log in to the emulated device and run the
|
|
|
|
|
`./transmogrify.sh` script from the `/home/user` directory. Reboot the device. When it comes
|
|
|
|
|
back, you will find that it is running Synit (check `ps` output to see that `synit-pid1` is in
|
|
|
|
|
fact PID 1).
|
|
|
|
|
|
|
|
|
|
## Build and install the user interface packages
|
|
|
|
|
|
|
|
|
|
If you want to run the SqueakPhone image on your local machine, ensure your Unix user is in the
|
|
|
|
|
`input` group.
|
|
|
|
|
|
|
|
|
|
squeak-phone: ./push-image-to-phone.sh pm-qemu
|
|
|
|
|
|
|
|
|
|
set `dpi.override` to have 256 in it
|
|
|
|
|
|
