Server configuration

Configure Kurpod server for optimal performance and security. Learn about all available options and best practices.

Command line options

Kurpod accepts the following command-line arguments:

kurpod_server [OPTIONS]

Options:
  -p, --port <PORT>              Port to listen on [default: 3000]
  -b, --blob <BLOB>              Path to blob file (single-blob mode)
      --blob-dir <DIR>           Directory containing blob files
  -h, --help                     Print help
  -V, --version                  Print version

Examples

# Basic usage with defaults
./kurpod_server

# Custom port and blob location
./kurpod_server --port 8080 --blob /secure/storage.blob

# Directory mode with verbose logging
./kurpod_server --blob-dir /data/blobs --log-level debug

Storage modes

Single blob mode

Best for personal use or small deployments:

# Command line
./kurpod_server --blob /secure/storage.blob


Characteristics:
- One file contains everything
- Easy to backup
- Simple permissions
- Limited scalability

### Directory mode

Better for larger deployments:

```bash
# Command line
./kurpod_server --blob-dir /data/blobs/

Directory structure:

/data/blobs/
├── default.blob      # Default blob
├── user1.blob       # Future: per-user blobs
├── user2.blob
└── shared.blob      # Future: shared storage