dockerscripts/linuxmint repository overview

⁠Linux Mint MATE in a Container

⁠Installation

⁠Making The Container

• First install ds: https://gitlab.com/docker-scripts/ds#installation⁠

• Then get the scripts: ds pull linuxmint

• Create a dir for the container: ds init linuxmint @linuxmint-1

• Fix the settings: cd /var/ds/linuxmint-1/; vim settings.sh

• Make the container: ds make

⁠Installing Additional Packages

You can go inside the docker container and install other packages with apt, like this:

cd /var/ds/linuxmint-1/
ds shell
apt install ubuntu-edu-preschool ubuntu-edu-primary firefox
exit

However, in case you rebuild the server (for example with ds make or ds remake), you will have to install them again manually. To install them automatically on each rebuild, create a file like /var/ds/linuxmint-1/packages with a content like this:

RUN DEBIAN_FRONTEND=noninteractive \
    apt install --yes \
        ubuntu-edu-preschool \
        ubuntu-edu-primary \
        firefox

See also packages.sample⁠.

⁠Usage

⁠Accessing With X2Go

In order to access this server with X2Go⁠, you should uncomment these lines on seetings.sh, before ds make:

### Forwarded ports
X2GO_PORT="2202"
PORTS="$X2GO_PORT:22"

This will allow port 2202 on the host to be forwarded to port 22 on the container. On the X2Go client you should use the port 2202.

You can change the port 2202 in settings.sh to something else (for example 22022).

Note: Make sure to allow the port 2202 (or 22022) on the firewall (for example with: ufw allow 2202).

Note: You can also access the server from terminal, like this:

ssh -p 2202 [email protected]

⁠Accessing From Guacamole

First install it: https://gitlab.com/docker-scripts/guacamole#installation⁠

Then add a Guacamole user and connection for accessing this server:

cd /var/ds/guac.example.org/
ds guac user add user1 pass1
ds guac server add linuxmint-1
ds guac user connect user1 linuxmint-1

Here linuxmint-1 is the name of the container (the option CONTAINER=linuxmint-1 on settings.sh).

⁠Managing User Accounts

The file accounts.txt contains a list of accounts in the form username:password, which are created automatically when the container is created. But they can also be re-created any time with a command like this:

ds users create accounts.txt

There are other commands and options which can be used to export, import, backup and restore user accounts, for example:

ds users backup
ds users restore backup/users-20190417.tgz

See also: ds inject users.sh help

⁠Epoptes Users

To allow one or more users to open Epoptes and watch the other users (usually these are the teachers), add them to the option EPOPTES_USERS on settings.sh. This has to be done before ds make.

You can also add them manually like this:

ds exec adduser user1 epoptes

However this is not persistent (after a ds make you will have to add them manually again).

⁠Admin Users

An admin user can install/uninstall packages with sudo apt ....

He can also create/backup/restore user accounts with sudo users ....

To add an admin user, uncomment and modify these lines on settings.sh:

## Admin account. Uncomment to enable.
ADMIN_USER="admin"
ADMIN_PASS="pass1"

You can also add an admin user manually, like this:

ds inject add-admin.sh user1 pass1

However this is not persistent (after a ds make you will have to add it manually again).

⁠Other Commands

ds help
ds stop
ds start
ds shell
ds remake