SaaS

Hemmelig is available at https://hemmelig.app

https://github.com/user-attachments/assets/fb237fdb-d811-4809-9d01-e0bb6e2b50be

How it works

1. Visit https://hemmelig.app and enter your sensitive information
2. Configure your secret:
   • Set expiration time
   • Add optional password
   • Set view limits or IP restrictions
3. Click "Create secret link" to generate a secure URL
4. Share the generated link with your recipient

The security model works by:

• Generating a unique encryption key for each secret
• Performing all encryption in your browser before sending to the server
• Including the decryption key only in the URL fragment (never stored on server)
• Server only stores the encrypted data, never the plain text or keys

Example encryption flow:

encryptedData = encrypt(yourSecretData, uniqueEncryptionKey)
// Only encryptedData is sent to server
// uniqueEncryptionKey is only shared via URL

Features

Core Security

• Client-side encryption for all private content
• Decryption key stored only in URL fragment, never in database
• Optional password protection layer
• IP address restriction capabilities
• Rate-limited API for abuse prevention

Secret Management

• Configurable secret lifetime
• Maximum view count limits
• Optional encrypted titles
• Base64 conversion support
• Rich text formatting with inline image support

File Handling

• Encrypted file uploads for authenticated users
• File size and type restrictions

Sharing Options

• Separate sharing of secret link and decryption key
• QR code generation for secret links
• Public paste option:
  • IP address logging for public pastes
  • No file upload support
  • Username-based public paste listing

User Features

• Extended secret expiration (14 and 28 days)
• Personal file upload management
• Secret listing and deletion
• Account management

Administrative Controls

• User registration management
• Read-only mode for non-admin users
• File upload restrictions
• User account creation controls
• Organization email domain restrictions

Deployment Options

• Self-hosted version available
• SQLite database with Prisma ORM
• CLI support for automation
• Regulatory compliance support

Docker image

Hemmelig strongly advice you to ue the tagged docker images as the main branch will have breaking changes now and then. For Hemmelig versions supporting Redis, use <= v4.4.0.

Supported docker platforms: amd/64, arm/64.

• hemmeligapp/hemmelig:latest (Is created on each version release)
• hemmeligapp/hemmelig:v5 (Is created on each version release for the major version)
• hemmeligapp/hemmelig:v5.19 (Is created on each version release for the major and minor version)
• hemmeligapp/hemmelig:v5.19.28 see tags for all version
• hemmeligapp/hemmelig:weekly (pushed every week on Friday)
• hemmeligapp/hemmelig:daily

Self-hosting

If you have to follow some sort of compliance, and have to self-host, https://hemmelig.app is available as a docker image. The following is the bare minimum to run the docker image.

mkdir -p data/hemmelig database
chown 1000:1000 data/hemmelig database

docker run -p 3000:3000 -d --name=hemmelig \
   -v ./data/hemmelig/:/var/tmp/hemmelig/upload/files \ # For the file uploads
   -v ./database/:/home/node/hemmelig/database/ \       # For the sqlite database
   hemmeligapp/hemmelig:v5.19.4

Alternatively you can use docker compose:

NEW: Sign in with Github and edit the docker-compose.yml here https://www.dockerfile.app/docker-compose/cm2qfl57s00061059n94ruje5

# fetch docker-compose.yml
wget https://raw.githubusercontent.com/HemmeligOrg/Hemmelig.app/main/docker-compose.yml

# create volumes directories
mkdir -p data/hemmelig database

# set permissions (Node user has UID 1000 within the container)
chown 1000:1000 data/hemmelig database

# start hemmelig 
docker compose up -d

# stop containers
docker compose down

Have a look at the Dockerfile for a full example of how to run this application.

CLI

Hemmelig can be used as a CLI to create secrets on the fly!

# Pipe data to hemmelig
cat mysecretfile | npx hemmelig

# For the documentaiton
npx hemmelig --help

Environment variables

Supported languages

Have a look at the public/locales/ folder.

Run locally

npm install

# Start the frontend/backend
npm run dev
# http://0.0.0.0:3001

Database

Hemmelig has changed from using Redis as an backend to sqlite. Here we are using Prisma, and the sqlite file is available here: /database/hemmelig.db. Have a look at the docker-compose.yml file for how to handle the database.

Admin, roles and settings

Admins have access to adjust certain settings in Hemmelig. If you go to the account -> instance settings, you can see all the settings.

We also have different roles.

• Admin
• Creator
• User

The difference here is that if you i.e. set Hemmelig to be in read only mode, only admin and creator is allowed to create secrets, but non signed in users, and users with the role user can only view them.

Admins are also allowed to create new users in the settings. This is great if you want to limit who your users are by the disable user account creation setting.

My lovely contributors

Contribution

Feel free to contribute to this repository. Have a look at CONTRIBUTION.md for the guidelines.

Common errors

If this errors occur on the first run of your hemmelig instance, this means there are some issues with the ownership of the files/directory for the database.

Datasource "db": SQLite database "hemmelig.db" at "file:../database/hemmelig.db"

Error: Migration engine error:
SQLite database error
unable to open database file: ../database/hemmelig.db

If you have any issues with uploading files for your instance, you will need the following as well:

Here is an example of how you would solve that:

sudo chown -R username.group /home/username/data/
sudo chown -R username.group /home/username/database/