Docker Deployment

Quick Start

docker run -d \
  --name requesto \
  -p 4747:4747 \
  -p 4748:4748 \
  -v requesto-data:/app/data \
  terrii/requesto:latest

Open http://localhost:4747.

Port 4748 is used for the Mock Server to allow you to create Mock APIs. If you don't plan on using this feature, there is no reason to expose the port.

Docker Compose

services:
  requesto:
    image: terrii/requesto:latest
    container_name: requesto
    restart: unless-stopped
    ports:
      - "4747:4747" # Required
      - "4748:4748" # Mock Server
    volumes:
      - requesto-data:/app/data
    environment:
      - NODE_ENV=production
      - PORT=4747
      - HOST=0.0.0.0

volumes:
  requesto-data:

docker-compose up -d

Environment Variables

Variable	Default	Description
NODE_ENV	production	Set to production to serve the frontend as static files
PORT	4747	Port the server listens on
MOCK_PORT	4748	Port the Mock Server listens on
HOST	0.0.0.0	Address to bind to
DATA_DIR	/app/data	Directory for JSON data files

Data Persistence

Mount a volume or bind-mount at /app/data. This directory holds all your data, organized by workspace:

data/
├── workspaces.json        # Workspace registry and active workspace
├── Default/               # Built-in workspace (named "Local Workspace")
│   └── .requesto/         # Requesto data for this workspace (git-tracked)
│       ├── order.json     # Display order of collections, environments, and configs
│       ├── collections/   # One JSON file per collection
│       ├── environments/  # One JSON file per environment and its initial variables
│       ├── oauth-configs/ # One JSON file per OAuth configuration (no client secrets)
│       ├── mock-endpoints/ # One JSON file per mock server endpoint
│       └── local/         # Local-only data (excluded from git)
│           ├── history.json  # Request/response history (last 100)
│           ├── oauth-secrets.json
│           └── mock-data/    # Dynamic mock server datasets
└── workspaces/            # Additional workspaces (created or git-cloned)

These are plain JSON files. You can back them up by copying the entire data directory:

docker cp requesto:/app/data ./backup

To restore, copy the directory back and restart:

docker cp ./backup/. requesto:/app/data
docker restart requesto

Building from Source

git clone https://github.com/t3rr11/Requesto.git
cd Requesto
docker build -t requesto:custom .
docker run -d -p 4747:4747 -p 4748:4748 -v requesto-data:/app/data requesto:custom

The Dockerfile uses a multi-stage build: backend and frontend are built in separate stages, then combined into a Node.js Alpine production image.

Health Check

curl http://localhost:4747/health

{"status": "ok"}

Reverse Proxy

If you're putting Requesto behind nginx or similar:

server {
    listen 80;
    server_name requesto.example.com;

    location / {
        proxy_pass http://localhost:4747;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        # Increase timeouts for long-running API requests
        proxy_read_timeout 600;
    }
}

Updating

docker-compose pull
docker-compose up -d

Or without Compose:

docker pull terrii/requesto:latest
docker stop requesto && docker rm requesto
docker run -d --name requesto -p 4747:4747 -p 4748:4748 -v requesto-data:/app/data terrii/requesto:latest

Troubleshooting

Container won't start - Check logs with docker logs requesto.

Port conflict - Change the host-side port: -p 8080:4747.

Permission issues on data directory - Make sure the mount path is writable.