Light license-key server in 1 file

• License Key Management - Generate, validate, and manage license keys with Ed25519 cryptographic signatures
• Multi-tier Licensing - Support for different license types (Trial, Standard, Enterprise, etc.) with customizable limits
• Customer Portal - Self-service portal for customers to manage their licenses
• Admin Dashboard - Comprehensive admin panel built with Vue3 and TailwindCSS
• Payment Integration - Built-in support for Stripe payment processing
• Database Support - SQLite (default) and PostgreSQL support
• Geo-location Tracking - Track license usage by country (MaxMind, IPinfo, GeoOpen)
• JWT Authentication - Secure API access with JWT tokens
• Email Notifications - Automated email notifications for license events
• Multi-currency Support - Handle payments in multiple currencies (USD, EUR, GBP, etc.)
• Audit Logging - Track all administrative actions
• RESTful API - Complete API for integration with your applications
• Single Binary - All features packed into one executable file
• Docker Support - Easy deployment with Docker and Docker Compose

Download the latest release for your platform from GitHub Releases:

# Linux
wget https://github.com/werbot/lime/releases/latest/download/lime-linux-amd64
chmod +x lime-linux-amd64
mv lime-linux-amd64 /usr/local/bin/lime

# macOS
wget https://github.com/werbot/lime/releases/latest/download/lime-darwin-amd64
chmod +x lime-darwin-amd64
mv lime-darwin-amd64 /usr/local/bin/lime

docker pull ghcr.io/werbot/lime:latest

# Run with Docker
docker run -d \
  -p 8088:8088 \
  -v $(pwd)/data:/data \
  --name lime \
  ghcr.io/werbot/lime:latest

# Clone the repository
git clone https://github.com/werbot/lime.git
cd lime

# Start with Docker Compose
docker compose -f docker/docker-compose.yaml up -d

# Clone the repository
git clone https://github.com/werbot/lime.git
cd lime

# Build frontend
yarn --cwd ./web run build

# Build and run
cd ./cmd
go build -o lime main.go
./lime serve

1. Download the latest release
2. Stop the running instance
3. Replace the old binary with the new one
4. Restart the service

# Backup your data
cp -r ./lime_base ./lime_base.backup
cp -r ./lime_keys ./lime_keys.backup

# Download and replace binary
wget https://github.com/werbot/lime/releases/latest/download/lime-linux-amd64
chmod +x lime-linux-amd64
mv lime-linux-amd64 /usr/local/bin/lime

# Restart service
systemctl restart lime

# Pull the latest image
docker pull ghcr.io/werbot/lime:latest

# Stop and remove old container
docker stop lime
docker rm lime

# Start with new image
docker run -d \
  -p 8088:8088 \
  -v $(pwd)/data:/data \
  --name lime \
  ghcr.io/werbot/lime:latest

lime gen --config

This creates lime.toml with default settings. Edit the file to configure:

• HTTP address and port (default: 0.0.0.0:8088)
• Admin credentials (default: [email protected] / Pass123)
• Database settings (SQLite or PostgreSQL)
• Geo-location provider
• Email settings

Keys are generated automatically on first run, or manually:

# Generate JWT keys
lime gen --jwt

# Generate license master keys
lime gen --license

lime serve

The server will start on http://0.0.0.0:8088

Navigate to http://localhost:8088/_/ and login with:

• Email: [email protected]
• Password: Pass123

1. Go to Admin Panel → Patterns
2. Create license patterns (e.g., Trial, Standard, Enterprise)
3. Define limits, pricing, and duration for each pattern

1. Add customers via Admin Panel → Customers
2. Create payments for customers
3. Generate license keys from payments

Start the license server.

lime serve

Server will start on the address defined in lime.toml (default: 0.0.0.0:8088)

Generate configuration files and cryptographic keys.

# Generate configuration file
lime gen --config

# Generate JWT key pair
lime gen --jwt

# Generate license master key pair
lime gen --license

Development helper scripts are available in the ./scripts folder:

# Install or update Go version
./scripts/golang

# Database migrations
./scripts/migrate dev up      # Apply migrations with fixtures
./scripts/migrate dev down    # Rollback migrations
./scripts/migrate up          # Apply migrations only
./scripts/migrate down        # Rollback migrations

# Optimize SQLite database
./scripts/sqlite

# Generate keys (alternative to 'lime gen')
./scripts/gen

# Clean up hung processes
./scripts/clear

Currently, Lime supports Stripe for payment processing. Additional payment providers can be added by extending the payment handler.

1. Get your Stripe API keys from Stripe Dashboard

2. Configure Stripe in your application by adding webhook URLs:

   • Webhook endpoint: https://yourdomain.com/_/api/webhook/stripe

3. Handle payment events in the admin panel:

   • Go to Admin Panel → Payments
   • View and manage payment transactions
   • Monitor payment status (Paid, Unpaid, Processed, Canceled, Failed)

To add support for additional payment providers:

1. Update internal/models/payments.go:

   const (
       _ PaymentProvider = iota
       NONE
       STRIPE
       YOUR_PROVIDER  // Add your provider
   )

2. Implement payment webhook handler in internal/handlers/admin/payment.go

3. Update frontend in web/src/utils/index.ts:

   export const paymentProvidersObj = [
       { name: "None", color: "gray" },
       { name: "Stripe", color: "purple" },
       { name: "YourProvider", color: "blue" },  // Add your provider
   ];

The backend is developed in Go language. The frontend (admin site and base site) operates on the Vue3 and TailwindCSS.

There are a number of scripts (in the ./scripts folder) that simplify development:
./scripts/golang - Installs or updates a previously installed version of go (if needed).
./scripts/migration - Helps to work with migrations. For instance, the ./scripts/migration dev up command will apply new migrations from folder ./migrations, then implement the migrations from folder ./fixtures.
./scripts/sqlite - Optimizes the existing database.
./scripts/gen - Generate JWT or master-License keys.
./scripts/clear - Removing hung golang or vite processes.

First run:

1. yarn --cwd ./web run build - This is necessary in order to be able to compile and run a go app.
2. cd ./cmd/ && go run main.go gen --config - (if need) To save the configuration file with default parameters for further modification
3. cd ./cmd/ && go run main.go serve - Launch the license server
4. yarn --cwd ./web run dev - (if need) If you need to change the server for if you're going to modify the UI admin or manager panel, it will launch a dev environment with Vite.

If you want to say thank you and/or support the active development of lime:

1. Add a GitHub Star to the project.

2. Tweet about the project on your Twitter

3. Write a review or tutorial on Medium, Dev.to or personal blog.

4. Support the project by donating a cup of coffee.

You can learn more about how you can contribute to this project in the contribution guide.