README.md 1.42 KB
Newer Older
Stefano Alberto Russo's avatar
Stefano Alberto Russo committed
1
# Containers
2

Stefano Alberto Russo's avatar
Stefano Alberto Russo committed
3
Various Docker and Singularity containers.
4

5
### Hierarchy
6
7
8
9
10
11
12
13

- Base
  - X11Web
     - MinimalDesktop
       - BasicDesktop
         - ViaLacteaVisualAnalytics
  - JupyterNotebook
  - SSH
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
    - XCalc

### Interfaces

The container starts by automatically exposing their interfaces:


 - The containers based on the X11Web container (as the desktops) expose a web-based VNC client (KasmVNC) on port 8590

- The JupyterNotebook container expose the Notebook server on port 8888

- The SSH container expose the OpenSSH server on port 22

All the containers support changing the default port using the `BASE_PORT` environment variable.


### Usage

You can eithe directly run the containers, e.g.:

34
    docker run -p8590:8590 registry.ict.inaf.it/exact/swc/basicdesktop:v0.3.0
35
36
37
 
 or use tham as base containers for your own ones:
 
38
    FROM registry.ict.inaf.it/exact/swc/basicdesktop:v0.3.0
39
40
41
42
43
44
45
46
47
48
49
50
51
 
 
### Supported engines
 
 These containers are built to be supported by nearly any container engine. These include:
 
  - Docker
  - Podman (rootful and rootless)
  - Singularity
 
 However, beware some permission errors which may arise after extending them and installing extra software, in particular with Singularity. You can add a line like this at the end of your Dockerfile to be sure the home folder is always set as writable by anyone (required for these containers to work with Singularity):
 
    # Fix home permissions
52
    RUN chmod 777 /home