added docs

README.md

@@ -1,7 +1,182 @@
-# cryptlex-onpremise
+# Cryptlex On-premise
 
-Cryptlex On-premise offers a self-hosted version of Cryptlex for organizations that need or want to manage their own data. It can be run in your existing environments.
+Cryptlex On-premise provides a fully self-hosted deployment of Cryptlex for organizations that require complete control over infrastructure, data residency, security, and network environments.
 
-Refer to following for documentation:
+It includes all major Cryptlex platform capabilities, including license management, activations, floating licenses, trials, entitlements, release management, and APIs, while allowing deployment within your own infrastructure.
 
-https://docs.cryptlex.com/cryptlex-on-premise/overview
+Cryptlex On-premise can be deployed in:
+
+* private cloud environments
+* enterprise data centers
+* staging and production clusters
+* regulated or compliance sensitive environments
+
+---
+
+## Documentation
+
+| Topic                                                                        | Description                          |
+| ---------------------------------------------------------------------------- | ------------------------------------ |
+ | [docs/000-overview.md](docs/000-overview.md)                                     | Overview of Cryptlex On-premise      |
+ | [docs/010-system-requirements.md](docs/010-system-requirements.md)               | Hardware and software requirements   |
+ | [docs/000-overview.md#server-layout](docs/000-overview.md#server-layout)         | Recommended deployment architectures |
+ | [docs/025-configuring-client-libraries.md](docs/025-configuring-client-libraries.md) | Configure SDKs for On-premise        |
+ | [docs/030-monitoring-your-instance.md](docs/030-monitoring-your-instance.md)     | Monitoring and observability setup   |
+
+---
+
+## Architecture Overview
+
+Cryptlex On-premise consists of multiple independently scalable services:
+
+* Cryptlex Web API
+* Cryptlex Release Server
+* PostgreSQL
+* Redis
+* Reverse proxy (Traefik)
+* MinIO or S3 compatible storage
+
+The services can be deployed either:
+
+* on a single server for development/testing
+* across multiple servers for staging and production environments
+
+---
+
+## Deployment Models
+
+### Single Server Deployment
+
+Recommended for:
+
+* development environments
+* testing
+* low volume deployments
+
+Features:
+
+* simple deployment
+* minimal infrastructure requirements
+* all services hosted together
+
+---
+
+### Distributed Deployment
+
+Recommended for:
+
+* production environments
+* high availability deployments
+* scalable enterprise workloads
+
+Features:
+
+* external PostgreSQL
+* external Redis
+* load balancer support
+* horizontal scaling
+* storage redundancy support
+
+---
+
+## System Requirements
+
+### Minimum Requirements
+
+| Resource   | Requirement        |
+| ---------- | ------------------ |
+| CPU        | Dual core          |
+| Memory     | 1 GB minimum       |
+| Storage    | 5 GB minimum       |
+| Docker     | 20.10.22 or higher |
+| PostgreSQL | 13.x or higher     |
+
+### Recommended Production Requirements
+
+| Resource | Recommendation                |
+| -------- | ----------------------------- |
+| CPU      | Quad core or higher           |
+| Memory   | 4 GB or higher                |
+| Storage  | SSD backed persistent storage |
+| Database | Managed PostgreSQL cluster    |
+| Cache    | Dedicated Redis instance      |
+
+---
+
+## Configuring Client Libraries
+
+By default, Cryptlex SDKs communicate with `api.cryptlex.com`.
+
+For On-premise deployments, configure your applications to use your self-hosted Cryptlex endpoint.
+
+Example using LexActivator:
+
+```c
+status = SetCryptlexHost("https://cryptlex-api.mycompany.com");
+```
+
+See:
+
+* [Configuring client libraries](docs/025-configuring-client-libraries.md)
+
+---
+
+## Monitoring
+
+Cryptlex supports integrations with:
+
+* New Relic
+* Bugsnag
+
+This allows monitoring of:
+
+* service health
+* application errors
+* infrastructure stability
+* alerting workflows
+
+See:
+* [Monitoring your instance](docs/030-monitoring-your-instance.md)
+
+---
+
+## Storage Components
+
+### PostgreSQL
+
+Primary database service used by Cryptlex Enterprise.
+
+### Redis
+
+Caching service used for performance optimization.
+
+### MinIO / S3 Compatible Storage
+
+Object storage service used for application file storage.
+
+---
+
+## Supported Platforms
+
+Cryptlex On-premise can run on:
+
+* Linux
+* Windows
+* macOS
+
+Provided Docker requirements are met.
+
+---
+
+## Support
+
+For assistance, enterprise inquiries, or deployment guidance:
+
+* [support@cryptlex.com](mailto:support@cryptlex.com)
+
+---
+
+## License
+
+Commercial software.
+Contact Cryptlex for licensing details.

docs/000-overview.md

@@ -0,0 +1,16 @@
+# Cryptlex On-premise
+
+Cryptlex On-premise offers a self-hosted version of Cryptlex for organizations that need or want to manage their own data. It can be run in your existing environments.
+
+Cryptlex On-premise has all the features of SaaS Cryptlex and regular releases ensure you are kept up to date. All client libraries can easily be configured to send license activation requests to your Cryptlex On-premise instance.
+
+## Server Layout
+
+![Single Server Layout](../assets/cryptlex-on-premise.png)
+
+This configuration uses a single server to host all of the components for Cryptlex including the web portals. In this deployment model, there is no service redundancy. For this reason, this model should be limited to the following purposes:
+
+* Development servers or workstations
+* Small production deployments
+
+To find out more or discuss your requirements please contact [support@cryptlex.com](mailto:support@cryptlex.com).

docs/010-system-requirements.md

@@ -0,0 +1,33 @@
+# System Requirements
+
+## Operating System
+
+Cryptlex On-premise is deployed using Docker. Hence it can be deployed on any Linux, Mac, and Windows-based servers that can run current versions of Docker (at least version 20.10.22 or higher).
+
+## Storage and Memory
+
+Cryptlex requires a minimum of 5GB to function for its database and docker images. Your exact storage size requirements will vary depending on the volume of licenses and the number of activations.
+
+Cryptlex requires at least 3GB of memory to function. If the database is also installed on the same server then at least 6GB of memory is required.
+
+## CPU
+
+Cryptlex requires at least a dual-core CPU, and that will work for low volume installations. For anything more than that we recommend going with a quad-core CPU.
+
+## Software
+
+### Docker
+
+Cryptlex requires at least version 20.10.22 (or higher) of Docker.
+
+### Database
+
+Cryptlex requires PostgreSQL 13.x (or higher) for storing all the data.
+
+### Cache
+
+Cryptlex uses Valkey (Redis) for storing the cache data.
+
+### Filestore
+
+It uses [Minio](https://www.minio.io/), which is an Amazon S3 compatible object storage server, for storing release files. In case you do not want to use the Cryptlex [release management](https://cryptlex.com/docs/release-management/overview) API, this is not required.