chenhsong/ichen-server repository overview

⁠Latest Version of Common Tags

⁠Mappings

⁠Ports

⁠Notes on Docker for Windows

For Windows containers, ports 34954, 5757 and 5788 are EXPOSEd in order to get around port-forwarding problems on Windows systems. If other ports are needed, then the --expose flag must be used to EXPOSE those ports.

⁠Files and Directories

⁠Command Line

⁠Linux

docker run -d -p 34954:34954 -p 5757:5757 -p 5788:5788 -v /path/to/logs:/app/logs chenhsong/ichen-server:version

⁠Windows

docker run -d -p 34954:34954 -p 5757:5757 -p 5788:5788 -v D:\path\to\logs:C:\app\logs chenhsong/ichen-server:version

⁠Advanced Configuration

The standard image contains typical configuration settings to run a single, stand-alone instance of the iChen® Server while providing most services. This is typically enough for most applications unless a large number of machines are concurrently connected. Even those cases may be more easily solved by upgrading to a more powerful server with more/faster CPU's, more memory etc.

When special features are being used (e.g. archiving to an external database, Auto-Login setting, provisioning an external archive database etc.), there may be a need to override the default settings on the system configuration file (iChenServer.config). To override system configuration settings, provide an alternative copy of iChenServer.config and map the appropriate file path inside the container to this alternative copy (via the docker run command):

-v /path/to/iChenServer.config:/app/iChenServer.config

A sample version of the configuration file can be obtained here⁠.

Format of the iChenServer.config file and all settings can be found in this document⁠.

⁠Configuring Logging

The iChen® Server uses Log4Net⁠ as its primary logging framework. Configuration settings for Log4Net reside in the file log4net.config.

To customize logging, provide an alternative log4net.config configuration file and map it via the docker run command:

-v /path/to/log4net.config:/app/log4net.config

⁠Configuring HTTPS

⁠Step 1

Provide an alternative iChenServer.config configuration file and map it via the docker run command:

-v /path/to/iChenServer.config:/app/iChenServer.config

⁠Step 2

Provide an SSL certificate and map it via the docker run command:

-v /path/to/my-certificate.p12:/app/assets/certificate.p12

The default certificate is self-signed and should only be used in developmental environment, not production.

⁠Step 3

Add the required settings in iChenServer.config:

⁠Step 4

Map the HTTP redirection port (specified in the iChenWeb_Http_Redirection_Port setting above) via the docker run command:

-p 80:5758

The above mapping, as an example, maps the iChenWeb_Http_Redirection_Port (which is assumed set to 5758) to the standard HTTP port of 80.