Add ability to use skins

.env

@@ -0,0 +1,8 @@
+# Incoming mail (IMAPS)
+IMAP_HOST=ssl://mail.eternityproject.fi
+IMAP_PORT=993
+
+# Outgoing mail (SMTP with STARTTLS)
+SMTP_HOST=mail.eternityproject.fi
+SMTP_PORT=587
+SMTP_AUTH_TYPE=PLAIN

.env.example

@@ -5,4 +5,8 @@ IMAP_PORT=143
 # Outgoing mail (SMTP with STARTTLS)
 SMTP_HOST=smtp.example.com
 SMTP_PORT=587
-SMTP_AUTH_TYPE=PLAIN
+SMTP_AUTH_TYPE=PLAIN
+
+# UI skin (elastic and larry are bundled; any roundcube/<name> Packagist skin
+# is installed automatically on container start)
+ROUNDCUBE_SKIN=elastic

README.md

@@ -9,4 +9,10 @@
 
 3. Open [http://localhost:9002](http://localhost:9002) and sign in with your mail credentials.
 
-The container publishes Roundcube on host port `9002`. SMTP uses port `587` by default and the `tls://` server prefix, which makes Roundcube negotiate STARTTLS. Its database is retained in the named `roundcube-db` volume.
+The container publishes Roundcube on host port `9002`. SMTP uses port `587` by default and the `tls://` server prefix, which makes Roundcube negotiate STARTTLS. Its database is retained in the named `roundcube-db` volume.
+
+## Skins
+
+Set `ROUNDCUBE_SKIN` in `.env` to choose the UI skin (default `elastic`). The image bundles `elastic` and `larry`; any other skin published as `roundcube/<name>` on Packagist (for example `roundcube/larry`) is installed automatically on container start. Because the web root is bind-mounted at `./var/www`, installed skins persist across container recreations.
+
+To use a custom third-party skin, drop its folder into `./var/www/html/skins/` and set `ROUNDCUBE_SKIN` to the folder name. Signed-in users can also pick any installed skin themselves under Settings → Preferences → User Interface.

docker-compose.yml

@@ -13,6 +13,7 @@ services:
       ROUNDCUBEMAIL_SMTP_USER: "%u"
       ROUNDCUBEMAIL_SMTP_PASS: "%p"
       ROUNDCUBEMAIL_SMTP_AUTH_TYPE: ${SMTP_AUTH_TYPE:-PLAIN}
+      ROUNDCUBEMAIL_SKIN: ${ROUNDCUBE_SKIN:-elastic}
     volumes:
       - roundcube-db:/var/roundcube/db
       - ./var/www:/var/www