Documents and folders
Sources, nested folders, upload with duplicate detection, versions, rename and move, favourites, and a trash with restore and permanent purge.
On-Premises edition
DocuSwift on your servers, in any data centre or cloud
The On-Premises edition is a self-hosted document management system. It runs as Docker containers with a PostgreSQL database and conventional file storage, so your documents, metadata and audit logs stay on infrastructure you control. Optional integrations such as AI summaries make outbound calls only if you switch them on.
Last updated
Runs wherever Linux containers run
- Your own data centre
- VMware and private cloud
- Microsoft Azure
- Google Cloud
- Oracle Cloud
- Amazon EC2
PostgreSQL 12+ · Redis 7 · Docker Compose · local disk, NAS or SAN storage
No policy requirement to self-host? Our recommended AWS Serverless edition costs less to run, needs no servers and includes every capability.
Why serverlessWhy self-host
Keep every document inside your own walls
Some institutions must keep documents in their own data centre. Others standardise on a cloud other than AWS, or want to reuse the PostgreSQL, storage and backup systems they already run. The On-Premises edition is built for them.
- Policy or a regulator requires documents in your own data centre
- You standardise on Azure, Google Cloud, Oracle Cloud, VMware or bare metal
- You want to reuse existing PostgreSQL, storage and backup investments
- Your IT team prefers to operate the stack itself
Branch & HQ staff
Web console
Administrators
Users, roles, audit
LOS · LMS · ERP
REST API & webhooks
Your data centre or cloud · Linux + Docker
Reverse proxy / load balancer
HTTPS with your certificate
Web console
Static files on your web server
DocuSwift API
Django REST · Gunicorn
Background worker
Celery · PDF, email, workflows
Scheduler
Cron · analytics jobs
Redis 7
Task queue
PostgreSQL 12+
Metadata, users, audit logs
File storage
Local disk, NAS or SAN
SMTP relay
Notifications
Optional, outbound only when enabled
Microsoft Entra ID
Single sign-on
Amazon Bedrock
AI summaries
FinHub API
Aadhaar masking
What's included
The core DocuSwift experience, self-hosted
Your teams get the same way of working with documents: sources and folders, metadata search, approvals, e-signatures and audit logs.
Check-out while editing
Lock a file while you work on it so nobody overwrites your changes, then unlock it with a new version.
Metadata and search
Metadata schemas and tags, bulk metadata upload from a spreadsheet, search by name or metadata, and Excel-driven bulk search with downloadable results.
Approvals and workflows
Multi-level approval flows with assignments and notifications, event-driven workflows, webhooks and calls to your own APIs.
E-signatures and sharing
Signature requests through secure links, per-item access control, shared items and public links for external parties.
Audit and access control
Admin-centre and file audit logs with export, roles, groups and source-level permissions, and user import and export.
Sign-in and MFA
Built-in sign-in with TOTP multi-factor authentication, password reset and invitation flows, plus Microsoft Entra ID sign-in.
Integrations
REST API with API keys and interactive Swagger documentation, webhooks, Aadhaar masking through FinHub and optional AI summaries.
Dashboard and branding
Daily, weekly and monthly usage analytics by source, and portal customisation with your logo and colours.
Requirements
What you need to run it
Conventional infrastructure your IT team already knows. No proprietary appliances and no cloud lock-in.
- 1
Provision
Prepare Linux hosts with Docker, a PostgreSQL database, a storage volume and an SMTP relay in the environment you choose.
- 2
Configure
Set the database, storage, email and secret-key settings in an environment file. Add Microsoft Entra ID, Bedrock or FinHub settings only if you want them.
- 3
Start
Start the API, worker, scheduler and Redis with Docker Compose. The API applies database migrations automatically on start-up.
- 4
Go live
Put your reverse proxy and certificate in front, create sources, roles and approval flows, then migrate your documents.
- Linux hosts with Docker
- Docker Engine and Docker Compose on one or more Linux servers or virtual machines, in your data centre or any cloud.
- PostgreSQL 12 or later
- Your own PostgreSQL server or a managed PostgreSQL service. DocuSwift creates and migrates its schema on start-up.
- Persistent storage
- A volume for documents and logs: local disk, or a NAS or SAN mount your backup tooling already covers.
- SMTP relay
- Any SMTP server for invitations, approval notifications and password resets.
- TLS in front
- A reverse proxy or load balancer that terminates HTTPS with your certificate.
- Sizing
- The reference Compose file allows the API up to 2 vCPU and 3 GB of memory and the worker up to 1.5 vCPU and 2 GB. Size PostgreSQL and storage for your document volume.
Compare
On-Premises vs. AWS Serverless
Choose On-Premises when policy requires control over where everything runs. Otherwise choose AWS Serverless: lower running cost, zero operations and the full feature set.
| Consideration | AWS Serverless editionRecommended | On-Premises edition |
|---|---|---|
| Infrastructure | ||
| Where it runs | Your AWS account, in the region you choose | Your data centre, private cloud or any public cloud |
| Running cost | Pay per use: Lambda and DynamoDB bill per request and S3 per GB, so nothing sits idle. Aavas Financiers reports 60% lower infrastructure management cost | You fund the servers, PostgreSQL, storage, backups and the staff time to run them, whether busy or idle |
| Application tier | AWS Lambda and Amazon API Gateway (REST + WebSocket) | Docker containers: Django REST API on Gunicorn, Celery worker, scheduler |
| Database | Amazon DynamoDB | PostgreSQL 12 or later |
| Document storage | Amazon S3, encrypted with AWS KMS | Local disk, NAS or SAN volume |
| Queue and cache | Managed AWS event services | Redis 7 (container included) |
| Sign-in | Amazon Cognito with TOTP MFA and Microsoft Entra ID | Built-in JWT sign-in with TOTP MFA and Microsoft Entra ID |
| Email notifications | Amazon SES | Your SMTP relay |
| Installation | AWS CloudFormation, launched from AWS Marketplace | Docker Compose on Linux hosts |
| Scaling | Automatic; no idle servers | Add CPU, memory or worker containers |
| Backup and DR | AWS Backup, cross-region replication, active-active option | Your existing PostgreSQL and storage backup tooling |
| Who operates the infrastructure | AWS managed services; nothing to patch | Your IT team: hosts, Docker, PostgreSQL and backups |
| Licensing | Annual plans on AWS Marketplace | Licensed directly by HabileLabs; quote on request |
| In both editions | ||
| Sources, nested folders, versions, favourites and sharing | Included | Included |
| Metadata schemas, tags and bulk metadata upload | Included | Included |
| Search by name and metadata, plus bulk search from an Excel list | Included | Included |
| Multi-level approval flows with an approver inbox | Included | Included |
| Event-driven workflows, webhooks and API integrations | Included | Included |
| Electronic signatures and controlled share links | Included | Included |
| Audit logs with filtering and export | Included | Included |
| Users, groups, roles and source-level access | Included | Included |
| TOTP multi-factor authentication and Microsoft sign-in | Included | Included |
| REST API and API keys | Included | Included |
| Aadhaar masking through FinHub | Included | IncludedOn-Premises calls the FinHub API when enabled |
| AI document summaries | Included | IncludedOn-Premises uses Amazon Bedrock when you supply credentials |
| Automatic PDF compression | Included | Included |
| Admin dashboard and white-label console | Included | Included |
| Delivered by the AWS edition today | ||
| Full-text search over OCR'd document content | Included | AWS edition today |
| Intelligent document processing with Amazon Textract and a review queue | Included | AWS edition today |
| Tamper-evident, hash-chained audit archive | Included | AWS edition today |
| Retention rules and legal holds | Included | AWS edition today |
| Compliance posture, access reviews and SIEM export | Included | AWS edition today |
| SharePoint two-way sync and Salesforce connector | Included | AWS edition today |
Want lower running cost and the full feature set without running servers? The AWS Serverless edition deploys into your own AWS account from AWS Marketplace.
AWS plansWhich edition should we choose?
We recommend the AWS Serverless edition. It is the more cost-effective edition to run: AWS services bill per use, so there are no idle servers, and there is no hardware or database to buy, patch or staff. It also includes every DocuSwift capability and a disaster-recovery install in every plan. Choose the On-Premises edition when policy or a regulator requires documents in your own data centre, or when you must run on a cloud other than AWS.
Can DocuSwift run outside AWS?
Yes. The DocuSwift On-Premises edition runs as Docker containers on Linux servers you control, with a PostgreSQL database and conventional file storage. You can install it in your own data centre, a private cloud such as VMware, or on any public cloud including Microsoft Azure, Google Cloud, Oracle Cloud and Amazon EC2.
What do we need to run the On-Premises edition?
Linux hosts with Docker Engine and Docker Compose, PostgreSQL 12 or later, a persistent volume for documents (local disk, NAS or SAN), an SMTP relay for notifications, and a reverse proxy or load balancer that terminates HTTPS. Redis is included as a container in the reference Compose file.
Does any data leave our network?
Not for core document management: documents, metadata and audit logs stay on your servers. AI summaries (Amazon Bedrock), Aadhaar masking (FinHub API) and Microsoft Entra ID sign-in are optional integrations that make outbound calls only when you enable and configure them.
How do the two editions differ in features?
Both editions share the core DMS: folders and versions, metadata and bulk search, approval flows, workflows and webhooks, e-signatures, audit logs with export, role-based access, TOTP MFA, Microsoft sign-in and the REST API. Intelligent document processing with Amazon Textract, full-text OCR search, the hash-chained audit archive, retention rules and legal holds, compliance posture, access reviews, SIEM export and the SharePoint and Salesforce connectors are currently delivered by the AWS Serverless edition.
Who operates the On-Premises edition?
Your IT team runs the hosts, Docker, PostgreSQL and backups, using the tools you already have. HabileLabs provides the software releases and helps with installation and configuration.
How is the On-Premises edition licensed?
The On-Premises edition is licensed directly by HabileLabs and quoted for your environment. The annual plans on AWS Marketplace cover the AWS Serverless edition. Contact us with your user count, document volume and hosting environment for a quote.
Get started
Plan your on-premises deployment
Share your hosting environment, user count and document volume. We will confirm the server, database and storage sizing and send a licence quote.
Or email info@habilelabs.io · Monday to Friday, 10:00–19:00 IST (excluding public holidays)