Skip to content

Emakin Installation

This section helps administrators choose and execute an Emakin deployment model. Use it when preparing a new environment, validating prerequisites, or deciding which installation path best fits your infrastructure.

Core Prerequisites

Emakin requires:

  • a relational database: PostgreSQL, Oracle, or MS SQL Server
  • a Redis-compatible cache: Redis or Dragonfly

Optional supporting services documented in this guide:

  • Tika Server for document indexing and OCR support
  • BaseX Server for XML storage and querying
  • ClamAV Server for virus scanning

The preserved documentation notes that mission-critical data is stored in the relational database, while Redis-compatible storage is used for caching.

Installation Paths

Docker Installation

Recommended when you want a containerized deployment on a single host or a simple multi-service stack.

Kubernetes Installation

Recommended when you want Helm-based deployment into a Kubernetes cluster.

Manual Installation

Recommended when you need direct control over the installed runtime on Windows, Linux, or macOS.

After Installation

Cloudflare Support

For Cloudflare SSL termination, the preserved documentation recommends:

1
2
3
4
environment:
    - AK_Web__ForwardedHeaders__ClearProxies=true
    - AK_Web__ForwardedHeaders__ClearKnownNetworks=true
    - AK_Web__ForwardedHeaders__ForwardedForHeaderName=CF-Connecting-IP

See SSL Termination for context.

Proxy Support

If the deployment runs behind an outbound proxy, set proxy environment variables in the container environment:

1
2
3
environment:
  - http_proxy=myproxyserver:8080
  - https_proxy=myproxyserver:8080

Replace the sample proxy value with the real host and port for your environment.