Server Configuration File

The server configuration is stored in /config/config.json and uses JSON format.

Configuration Structure

The configuration file has the following top-level sections:

global - Global server settings
server - Server-specific settings
cpu-binding - CPU core binding configuration
namespaces - Application namespace definitions

Global Section

global.path

Base path settings for the server.

global.path.base

Base directory for web content.

Type: string
Example: "/var/www"

global.tcp

TCP connection settings.

global.tcp.cork

Enable/disable TCP cork option.

Type: boolean
Default: false

global.tcp.nodelay

Enable/disable TCP_NODELAY option (Nagle’s algorithm).

Type: boolean
Default: true

Server Section

server.runas

User and group settings for dropping privileges after startup.

server.runas.user

Unix user name to run the server as.

Type: string
Example: "x0-http"

server.runas.group

Unix group name to run the server as.

Type: string
Example: "x0-http"

server.connection

Connection and network settings.

server.connection.timeout

Connection timeout in seconds.

Type: string (numeric value)
Example: "600"

server.connection.ipv4.address

IPv4 address to bind the server to.

Type: string
Example: "127.0.0.1"
Default: "127.0.0.1"

server.connection.ipv4.port

Port number to listen on.

Type: integer
Example: 80
Default: 80

server.mimetypes

List of supported MIME types for static file serving.

server.mimetypes

Array of file extensions that are allowed to be served.

Type: array of string
Example: ["html", "js", "json", "css", "png", "jpg", "svg", "woff2", "ico"]

CPU Binding Section

CPU core binding configuration for different server components.

cpu-binding.main-server

CPU cores assigned to the main server process.

Type: array of integer
Example: [0]

cpu-binding.staticfs

CPU cores assigned to static file serving processes.

Type: array of integer
Example: [1]

cpu-binding.app-server

CPU cores assigned to application server processes.

Type: array of integer
Example: [2, 3]

Namespaces Section

Application namespaces define virtual hosts and application server configurations.

Each namespace is an object in the namespaces array with the following properties:

id

Unique identifier for the namespace.

Type: string
Example: "app1"

hostname

Virtual hostname for this namespace.

Type: string
Example: "testapp1.local"

path

File system path to the application.

Type: string
Example: "/app1"

interpreters

Number of Python interpreter processes to spawn for this namespace.

Type: integer
Example: 5

cache-control

Cache control headers for responses.

Type: object

cache-control.type

Cache type (public or private).

Type: string
Values: "public", "private"
Example: "private"

cache-control.max-age

Maximum age in seconds for cached content.

Type: integer
Example: 3600

access

Access control and routing configuration.

Type: object

access.as-post

POST request routing configuration.

Type: object
Maps URL paths to Python methods or false to deny access
Example: {"/": "default", "/endpoint": false}

access.as-get

GET request routing configuration.

Type: object
Can map to simple method name or object with params
Example: {"/endpoint": {"params": ["param1", "param2"], "method": "method_name"}}

Example Configuration

{
    "global": {
        "path": {
            "base": "/var/www"
        },
        "tcp": {
            "cork": false,
            "nodelay": true
        }
    },
    "server": {
        "runas": {
            "user": "x0-http",
            "group": "x0-http"
        },
        "connection": {
            "timeout": "600",
            "ipv4": {
                "address": "127.0.0.1",
                "port": 80
            }
        },
        "mimetypes": [
            "html", "js", "json", "css", "png", "jpg", "svg", "woff2", "ico"
        ]
    },
    "cpu-binding": {
        "main-server": [0],
        "staticfs": [1],
        "app-server": [2, 3]
    },
    "namespaces": [
        {
            "id": "app1",
            "hostname": "testapp1.local",
            "path": "/app1",
            "interpreters": 5,
            "cache-control": {
                "type": "private",
                "max-age": 3600
            },
            "access": {
                "as-post": {
                    "/": "default"
                }
            }
        }
    ]
}