|
|
[features](features) |
|
|
\ No newline at end of file |
|
|
|
|
|
# Burn-Down of included features and status:
|
|
|
[features](features)
|
|
|
|
|
|
# Minimal Ubuntu Desktop Setup
|
|
|
_This set of scripts will install packages required to extend Ubuntu 18.04 Server for use as an exhibit machine._
|
|
|
|
|
|
---
|
|
|
### 0. `Ubuntu Server 18.04`
|
|
|
1. Install Ubuntu Server 18.04 using the typical (_guided use entire disk_) method.
|
|
|
2. Select `install openssh` when prompted
|
|
|
3. Do not install additional packages at this time
|
|
|
4. reboot and remove installation media
|
|
|
|
|
|
Now is a good time to **setup networking**, using [netplan](https://netplan.io/).
|
|
|
In the future, there will be a script/template for this as well.
|
|
|
|
|
|
**NOTE:** If you have an interface that is not used, add `required: false` to `/etc/netplan.yml` for that interface to avoid kernel waiting on `systemd-networkd-wait-online`
|
|
|
|
|
|
## Run the following steps via ssh session:
|
|
|
(with the exception of 1., these can all be run from within cockpit)
|
|
|
|
|
|
### 1. `server_script.sh`
|
|
|
_This script will install the needed packages for the display manager and window manager, as well as `cockpit` remote monitor and Third-party hardware drivers. It will also create an ~/exhibit/directory and add a start script. Optionally, it will install a default release of electron and modify the start script to run it around ~/exhibit/electron-app_
|
|
|
|
|
|
1. run the script `./base_install.sh`
|
|
|
2. Optionally install electron binaries (this step can be run later by executing `electron_install.sh`)
|
|
|
3. reboot to enter the desktop environment.
|
|
|
|
|
|
[Further Documentation](base_install)
|
|
|
|
|
|
### 2. `fluxbox_config.sh`
|
|
|
_This script shuts down the user-session, clones a default fluxbox config (theme, menus, etc), then restarts the user-session._
|
|
|
|
|
|
1. run the script `./fluxbox_config.sh`
|
|
|
2. when prompted, enter your **gitlab.monadnock.org** username and password.
|
|
|
|
|
|
**NOTE:** fluxbox will be configured to execute `~/exhibit/start.sh` at startup.
|
|
|
[Further Documentation](fluxbox)
|
|
|
|
|
|
### 3. `lightdm_setup.sh`
|
|
|
_This script will generate the following lightdm config, disallowing guest access, enabling autologin, and explicitly setting the session and greeter_
|
|
|
|
|
|
```
|
|
|
[SeatDefaults]
|
|
|
allow-guests=false
|
|
|
user-session=fluxbox
|
|
|
greeter-session=unity-greeter
|
|
|
autologin-user=USER
|
|
|
autologin-user-timeout=0
|
|
|
``` |