Webtop for StartOS

Webtop is an innovative Linux desktop environment that allows users to access a complete Linux desktop directly from their web browser. This repository creates the s9pk package that is installed to run Webtop on StartOS. Learn more about service packaging in the Developer Docs.

Dependencies

Install the system dependencies below to build this project by following the instructions in the provided links. You can also find detailed steps to setup your environment in the service packaging documentation.

• docker
• docker-buildx
• yq
• deno
• make
• start-sdk

Cloning

Clone the Webtop package repository locally.

git clone git@github.com:k0gen/webtop-startos.git
cd webtop-startos

Building

To build the Webtop service as a universal package, run the following command:

make

Alternatively the package can be built for individual architectures by specifying the architecture as follows:

make x86

or

make arm

Installing (on StartOS)

Before installation, define host: https://server-name.local in your ~/.embassy/config.yaml config file then run the following commands to determine successful install:

:information_source: Change server-name.local to your Start9 server address

start-cli auth login
#Enter your StartOS password
make install

Tip: You can also install the webtop.s9pk by sideloading it under the StartOS > System > Sideload a Service section.

Verify Install

Go to your StartOS Services page, select Webtop, configure and start the service.

Done!