Skip to content
RAMP Documentation

Docker Lite

RAMP Lite is a minimal Docker deployment designed for quick demos, evaluation, and small teams. It uses SQLite and local file storage, so there is no external database or object store to configure.

Best for

  • Quick demos and evaluation
  • Small teams (1—10 users)
  • Development and testing
  • Air-gapped or offline environments

Limitations

  • Not suitable for more than 10 concurrent users
  • No horizontal scaling (single API instance)
  • No enterprise authentication (LDAP/OIDC)
  • Files stored locally (not shared across instances)

Prerequisites

Section titled “Prerequisites”
  • Docker Desktop 4.0+ or Docker Engine 20.10+
  • Docker Compose 2.0+
  • Available RAM: 2 GB minimum
  • Disk Space: 5 GB minimum

Quick start

Section titled “Quick start”

  1. Navigate to the RAMP directory:

    Terminal window
    cd /path/to/RAMP

  2. Start RAMP Lite:

    Terminal window
    docker-compose -f docker-compose.lite.yml up -d --build

    On the first run this builds the Docker images, which takes 3—5 minutes.

  3. Wait for startup (typically 20—30 seconds):

    Terminal window
    docker-compose -f docker-compose.lite.yml logs -f
    # Wait for: "Application started. Press Ctrl+C to shut down."

  4. Open your browser at http://localhost.

Default credentials

Section titled “Default credentials”
AccountValue
Emailadmin@ramp.local
PasswordAdmin123!

Service URLs

Section titled “Service URLs”
ServiceURLDescription
Web Applicationhttp://localhostMain RAMP interface
API (direct)http://localhost:5000/apiAPI endpoints (bypass Nginx)
Health Checkhttp://localhost:5000/healthAPI health status

Data persistence

Section titled “Data persistence”

All data is stored in Docker volumes:

Terminal window
docker volume ls | grep ramp
# ramp-lite-data      (SQLite database)
# ramp-lite-logs      (Application logs)
# ramp-lite-uploads   (File attachments)

Backup

Section titled “Backup”
Terminal window
mkdir -p ./backups


# Backup database
docker cp ramp-api:/app/data/ramp.db ./backups/ramp_$(date +%Y%m%d).db


# Backup uploads
docker cp ramp-api:/app/uploads ./backups/uploads_$(date +%Y%m%d)

Restore

Section titled “Restore”
Terminal window
# Stop containers
docker-compose -f docker-compose.lite.yml stop


# Restore database
docker cp ./backups/ramp_20260110.db ramp-api:/app/data/ramp.db


# Restore uploads
docker cp ./backups/uploads_20260110 ramp-api:/app/uploads


# Start containers
docker-compose -f docker-compose.lite.yml start

Common operations

Section titled “Common operations”

View logs

Section titled “View logs”
Terminal window
# All logs
docker-compose -f docker-compose.lite.yml logs -f


# API logs only
docker-compose -f docker-compose.lite.yml logs -f ramp-api


# Last 50 lines
docker-compose -f docker-compose.lite.yml logs --tail=50

Restart services

Section titled “Restart services”
Terminal window
# Restart all
docker-compose -f docker-compose.lite.yml restart


# Restart API only
docker-compose -f docker-compose.lite.yml restart ramp-api

Stop services

Section titled “Stop services”
Terminal window
docker-compose -f docker-compose.lite.yml stop

Update to latest version

Section titled “Update to latest version”
Terminal window
git pull
docker-compose -f docker-compose.lite.yml up -d --build

Configuration

Section titled “Configuration”

Change the JWT secret

Section titled “Change the JWT secret”

For anything beyond a quick demo, set a custom JWT secret:

Terminal window
# Create or edit .env file
echo 'JWT_SECRET=YourRandomSecretKeyAtLeast32CharactersLong!' > .env


# Restart
docker-compose -f docker-compose.lite.yml down
docker-compose -f docker-compose.lite.yml up -d

User management

Section titled “User management”

Create a new user

Section titled “Create a new user”
  1. Log in as admin.
  2. Navigate to Admin then Users.
  3. Click Create User.
  4. Fill in email (used as username), display name, and password (minimum 8 characters).
  5. Assign roles (Administrator, Template Creator, etc.).
  6. Click Save.

Reset a user password

Section titled “Reset a user password”

Navigate to Admin then Users, find the user, click Edit, then Reset Password.

Troubleshooting

Section titled “Troubleshooting”

Cannot access http://localhost

Section titled “Cannot access http://localhost”
Terminal window
# Check container status
docker-compose -f docker-compose.lite.yml ps

Expected output should show ramp-api as Up (healthy) and ramp-web as Up.

Common causes:

  • Port 80 already in use — stop other services using port 80
  • Port 5000 already in use — stop other services using port 5000

Database connection error

Section titled “Database connection error”
Terminal window
# Check database file
docker-compose -f docker-compose.lite.yml run --rm ramp-api ls -la /app/data/


# Restart
docker-compose -f docker-compose.lite.yml restart

Database is corrupted

Section titled “Database is corrupted”
Terminal window
docker-compose -f docker-compose.lite.yml down
docker volume rm ramp-lite-data
docker-compose -f docker-compose.lite.yml up -d

Files not uploading

Section titled “Files not uploading”
Terminal window
# Check permissions
docker-compose -f docker-compose.lite.yml exec ramp-api ls -la /app/uploads


# Fix permissions
docker-compose -f docker-compose.lite.yml exec ramp-api chown -R app:app /app/uploads
docker-compose -f docker-compose.lite.yml restart ramp-api

High memory usage

Section titled “High memory usage”

RAMP Lite normally uses around 500 MB of RAM. If usage is higher:

Terminal window
# Check memory usage
docker stats ramp-api


# Restart to clear caches
docker-compose -f docker-compose.lite.yml restart ramp-api

Resource usage

Section titled “Resource usage”
ResourceTypical usage
RAM500 MB — 1 GB
CPU5—15% (idle)
Disk500 MB (base) + data/uploads
Startup time20—30 seconds

Monitoring

Section titled “Monitoring”
Terminal window
# API health check
curl http://localhost:5000/_health


# Database size
docker exec ramp-api du -h /app/data/ramp.db


# Live logs
docker-compose -f docker-compose.lite.yml logs -f --tail=100

When to upgrade

Section titled “When to upgrade”

Consider upgrading from Lite to Docker Full or Docker Cluster if:

  • You have more than 10 concurrent users
  • You need enterprise authentication (LDAP/OIDC)
  • You need high availability (no downtime during updates)
  • You need centralized file storage
  • You need horizontal scaling

Migration to Full or Cluster

Section titled “Migration to Full or Cluster”

  1. Backup the Lite database:

    Terminal window
    docker cp ramp-api:/app/data/ramp.db ./ramp_lite_backup.db

  2. Export to SQL:

    Terminal window
    sqlite3 ramp_lite_backup.db .dump > ramp_export.sql

  3. Set up the Full or Cluster deployment (see the respective guides).

  4. Import data to PostgreSQL:

    Terminal window
    # Convert SQLite SQL to PostgreSQL format (manual editing required)
    cat ramp_export.sql | docker exec -i ramp-db psql -U ramp -d ramp
Section titled “Related topics”
Docker Full Single-server production deployment with PostgreSQL, LDAP, and Nginx
Docker Cluster Multi-node high-availability deployment with load balancing, Redis, and MinIO
Application Settings Reference Complete reference for RAMP's appsettings.json configuration