/xspice

xorg spice via html5

Primary LanguageDockerfile

Containerized Xorg Desktop Accessed via SPICE/HTML5, Fork from here

Containerized remote Xorg Desktop using Spice, can be accessed using the included Html5 client.

It uses basic lightweight OpenBox, you can make OpenBox awesome if you like by:

  • adding background image using feh
  • adding panels using tint2
  • fancy display of information using conky

Use cases

Can be used to provide

  • light weight remote desktops
  • automation (launch firefox/chrome and do some automated tests)
  • in-browser IDEs
  • access a service from different place

Using SPICE clients

The origin project has published docker image on docker hub you can see it here.

You can use any remote desktop client that support spice protocol.

First you need to start the server, which is in our case a container

build the image using fedora27

docker build --network=host . -t xspice

run the container

docker run -d -p 5900:5900 --name myspice xspice

you can install more software by entering the container and your applications

docker exec -ti -u root myspice /bin/bash
dnf install eclipse firefox

Using the included HTML5 client

We have included HTML5 client, so you can run the entire stack of

  • your SPICE desktop
  • static files serving the HTML5 client
  • websockify to tunnel SPICE into websocket

you can do this using one the following commands

git clone https://github.com/54shady/xspice.git
cd xspice
docker-compose up -d

Then open your browser on port 8080

you can enter it to install packages like this

docker exec -ti -u root xspice_desktop_1 /bin/bash
dnf install -y arandr

destroy container

docker-compose down

Customization

This image uses a regular user app, place any executable file in /home/app/.config/openbox/autostart.d/ which will be executed in background during start up.

currently it only launches xterm

the spice password is 123456, which is set in /etc/X11/spiceqxl.xorg.conf

    Option "SpicePassword" "123456"