XnViewMP

XnViewMP

Docker app from Djoss' Repository

Overview

XnView is a powerful, versatile and free image viewer, photo management, and image resizer software. XnView is one of the most stable, user-friendly, and comprehensive photo management tools available today, perfect for both beginners and professionals. All common picture and graphics formats are supported (JPEG, TIFF, PNG, GIF, WEBP, PSD, JPEG2000, JPEG-XL, OpenEXR, camera RAW, HEIF, HEIC, AVIF, DICOM, PDF, DNG, CR2). The graphical user interface (GUI) of the application can be accessed through a modern web browser, requiring no installation or configuration on the client side, or via any VNC client. The container is built against Alpine Linux to provide an efficient image in terms of size and resource usage. For a complete documentation of this container, see https://github.com/jlesage/docker-xnview-mp#readme

Runtime arguments

Web UI
http://[IP]:[PORT:5800]
Network
bridge
Privileged
false

Template configuration

Config DirectoryPathrw

Stores the application's configuration, state, logs, and any files requiring persistency.

Target
/config
Default
/mnt/user/appdata/xnview-mp
StoragePathrw

Contains files from the host that need to be accessible to the application.

Target
/storage
Default
/mnt/user
User IDVariable

ID of the user the application runs as.

Target
USER_ID
Default
99
Group IDVariable

ID of the group the application runs as.

Target
GROUP_ID
Default
100
UmaskVariable

Mask controlling permissions for newly created files and folders, specified in octal notation.

Target
UMASK
Default
0000
Niceness (priority)Variable

Priority at which the application should run. A niceness value of `-20` is the highest, `19` is the lowest and `0` the default. NOTE: Setting a negative value requires additional permissions. Thus, `--cap-add=SYS_NICE` must be added to Extra Parameters (shown when Advanced View is enabled).

Target
APP_NICENESS
Default
0
Display WidthVariable

Width (in pixels) of the application's window.

Target
DISPLAY_WIDTH
Default
1920
Display HeightVariable

Height (in pixels) of the application's window.

Target
DISPLAY_HEIGHT
Default
1080
Dark ModeVariable

When set to `1`, enables dark mode for the application.

Target
DARK_MODE
Default
0
Web AudioVariable

When set to `1`, enables audio support, allowing audio produced by the application to play through the browser.

Target
WEB_AUDIO
Default
0
Web File ManagerVariable

When set to `1`, enables the web file manager, allowing interaction with files inside the container through a web browser, supporting operations like renaming, deleting, uploading, and downloading.

Target
WEB_FILE_MANAGER
Default
0
Web File Manager Allowed PathsVariable

Comma-separated list of paths within the container that the file manager can access. By default, the container's entire filesystem is not accessible, and this variable specifies allowed paths. If set to `AUTO`, commonly used folders and those mapped to the container are automatically allowed. The value `ALL` allows access to all paths (no restrictions).

Target
WEB_FILE_MANAGER_ALLOWED_PATHS
Default
AUTO
Web File Manager Denied PathsVariable

Comma-separated list of paths within the container that the file manager cannot access. A denied path takes precedence over an allowed path.

Target
WEB_FILE_MANAGER_DENIED_PATHS
Default
None
Web Desktop NotificationsVariable

When set to `1`, enables the web notification service, allowing the browser to display desktop notifications from the application.

Target
WEB_NOTIFICATION
Default
0
Web TerminalVariable

When set to `1`, enables access to a terminal from the web interface. It is strongly recommended to configure the container with secure web access (HTTPS).

Target
WEB_TERMINAL
Default
0
Web AuthenticationVariable

When set to `1`, protects the application's GUI with a login page when accessed via a web browser. Access is granted only with valid credentials.

Target
WEB_AUTHENTICATION
Default
0
Web Authentication Token Validity TimeVariable

Lifetime of a token, in hours. A token is assigned to the user after successful login. As long as the token is valid, the user can access the application's GUI without logging in again. Once the token expires, the login page is displayed again.

Target
WEB_AUTHENTICATION_TOKEN_VALIDITY_TIME
Default
24
Web Authentication UsernameVariable

Optional username for web authentication. Provides a quick and easy way to configure credentials for a single user. For more secure configuration or multiple users, see the documentation.

Target
WEB_AUTHENTICATION_USERNAME
Web Authentication PasswordVariable

Optional password for web authentication. Provides a quick and easy way to configure credentials for a single user. For more secure configuration or multiple users, see the documentation.

Target
WEB_AUTHENTICATION_PASSWORD
Secure ConnectionVariable

When set to `1`, uses an encrypted connection to access the application's GUI (via web browser or VNC client).

Target
SECURE_CONNECTION
Default
0
Secure Connection VNC MethodVariable

Method used for encrypted VNC connection. Possible values are `SSL` or `TLS`.

Target
SECURE_CONNECTION_VNC_METHOD
Default
SSL
Secure Connection Certificate Check IntervalVariable

Interval, in seconds, at which the system checks if web or VNC certificates have changed. When a change is detected, affected services are automatically restarted. A value of `0` disables the check.

Target
SECURE_CONNECTION_CERTS_CHECK_INTERVAL
Default
60
Web Listening Port (Non-Bridge Network Type)Variable

Port used by the web server to serve the application's GUI. This port is internal to the container and typically does not need to be changed. NOTE: This setting is relevant only when the Network Type is set to something else than Bridge.

Target
WEB_LISTENING_PORT
Default
5800
VNC Listening Port (Non-Bridge Network Type)Variable

Port used by the VNC server to serve the application's GUI. This port is internal to the container and typically does not need to be changed. NOTE: This setting is relevant only when the Network Type is set to something else than Bridge.

Target
VNC_LISTENING_PORT
Default
5900
WEB Port for GUI (Bridge Network Type)Porttcp

Port to access the application's GUI via the web interface. NOTE: This setting is relevant only when the Network Type is set to `Bridge`.

Target
5800
Default
7804
VNC Port for GUI (Bridge Network Type)Porttcp

Port to access the application's GUI via VNC protocol. Optional if no VNC client is used. NOTE: This setting is relevant only when the Network Type is set to `Bridge`.

Target
5900
Default
7904

Download Statistics

6,243
Total Downloads

Details

Repository
jlesage/xnview-mp
Last Updated2026-03-14
First Seen2025-08-01

Run XnViewMP on Unraid.

XnViewMP is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.