btouchard/ackify-ce v1.3.0 on GitHub

Major release introducing an integrated document reader, native file storage and a complete user interface redesign.

What's New

Integrated Document Reader

Direct viewing: intelligent reader allowing document reading without leaving the application (PDF, Markdown, HTML (sanitized))
Smart read tracking: Automatic detection of complete document reading with scroll tracking
Integrity verification: Checksum validation on each load to guarantee document authenticity
Configurable reading options:
- Read mode: integrated (embedded reader) or external (link to external URL)
- Download authorization (enabled/disabled per document)
- Full read required before signing (optional)

Document Storage

Native file upload: Direct upload of PDFs and other documents (in addition to existing URLs)
Storage providers: S3 support (MinIO compatible) and local storage
Automatic S3 bucket creation: Bucket is automatically created if it doesn't exist
Automatic MIME detection: Extended support including ODF formats (LibreOffice/OpenOffice)
Automatic checksum calculation: SHA-256 computed on upload to guarantee integrity

New "Technical Trust" Design

Complete interface redesign: Modern design system with a professional visual identity
IBM Plex fonts: Technical typography optimized for readability
Slate palette: Professional and sober colors
Dark mode: Native dark theme support
New logos and icons: Renewed visual identity with PWA icons

Tenant Configuration via Admin Interface

Admin settings page: Runtime configuration without application restart
SMTP configuration: Integrated connection test to validate email settings
OIDC/OAuth2 configuration: Endpoint and credential validation
S3 configuration: Connectivity test to verify storage access
Hot-reload: Apply changes without service interruption
Encrypted secrets: Secure AES-256-GCM storage of sensitive information

Anonymous Telemetry (Optional)

Usage metrics: Anonymous collection of documents, confirmations, webhooks and reminders count
Opt-in only: Disabled by default, enable via ACKIFY_TELEMETRY=true
SHM SDK integrated: Integration with SHM metrics service

Migrations

New Migrations

Migration	Description
`0017_add_reader_fields_to_documents`	Adds reader configuration fields (read_mode, allow_download, require_full_read, verify_checksum)
`0018_add_storage_fields_to_documents`	Adds storage fields (storage_key, storage_provider, file_size, mime_type, original_filename)
`0019_add_tenant_config`	Creates tenant_config table for dynamic per-tenant configuration

Configuration

New Environment Variables

# Telemetry (optional, disabled by default)
ACKIFY_TELEMETRY=false

# S3 Storage (optional)
ACKIFY_STORAGE_PROVIDER=s3          # 's3' or 'local'
ACKIFY_STORAGE_S3_ENDPOINT=...      # S3 Endpoint (e.g., minio.example.com)
ACKIFY_STORAGE_S3_BUCKET=...        # Bucket name
ACKIFY_STORAGE_S3_ACCESS_KEY=...    # S3 Access key
ACKIFY_STORAGE_S3_SECRET_KEY=...    # S3 Secret key
ACKIFY_STORAGE_S3_REGION=...        # Region (optional)
ACKIFY_STORAGE_S3_USE_SSL=true      # Use HTTPS (default: true)

# Local Storage (optional)
ACKIFY_STORAGE_LOCAL_PATH=/data     # Local storage path

Useful Links

Full changelog: https://github.com/btouchard/ackify-ce/blob/main/CHANGELOG.md
Documentation: https://github.com/btouchard/ackify-ce/blob/main/README.md
Diff: v1.2.8...v1.3.0

Upgrading from v1.2.8

This version is 100% backward compatible with v1.2.8. Existing documents continue to work in external URL mode.

Update

Via the installation script (recommended)

bash <(curl -fsSL https://raw.githubusercontent.com/btouchard/ackify-ce/main/install/install.sh)

The script automatically detects the existing installation and performs the upgrade.

Manually with Docker Compose

docker compose pull
docker compose up -d

Migrations are applied automatically at startup:

Existing documents default to integrated mode (transparent behavior)
New storage columns remain null for existing URL documents
The tenant_config table is created for runtime configuration

Enable File Storage

To allow document uploads instead of just URLs:

Option 1: S3 Storage (recommended for production)

ACKIFY_STORAGE_PROVIDER=s3
ACKIFY_STORAGE_S3_ENDPOINT=s3.amazonaws.com
ACKIFY_STORAGE_S3_BUCKET=ackify-documents
ACKIFY_STORAGE_S3_ACCESS_KEY=your_access_key
ACKIFY_STORAGE_S3_SECRET_KEY=your_secret_key

Option 2: Local Storage (development)

ACKIFY_STORAGE_PROVIDER=local
ACKIFY_STORAGE_LOCAL_PATH=/app/data/uploads

Enable Telemetry (optional)

ACKIFY_TELEMETRY=true

Telemetry helps me understand Ackify usage to improve the product. NO PERSONAL DATA IS COLLECTED.

btouchard/ackify-ce v1.3.0 Ackify CE v1.3.0 - Integrated Reader, Storage & New Design on GitHub