## Deploy AxonASP fast, scale confidently

From proof-of-concept to production, AxonASP 2.2 provides practical deployment paths with Docker, native build scripts, reverse proxy mode, and FastCGI support.

Port 8801 default proxy mode FastCGI integration available Viper configuration support
↓ Download Latest Release Read Full Setup Manual Open Repository

### Deployment highlights

- Start quickly with containerized runtime workflows.
- Run both VBScript and JavaScript concomitantly in any environment.
- Ensure reliability with the integrated `AxonASP TestSuite`.
- Use proxy or FastCGI based on your infrastructure model.
- Keep feature parity across server, FastCGI, and CLI runtime modes.
- Centralize config with `axonasp.toml` and `.env`.

# Quick deployment and installation guide

Choose the deployment mode that best fits your platform and operations flow. The steps below are optimized for quick adoption and predictable production behavior.

## 1. Docker deployment

### Clone and launch

With Docker and Docker Compose installed, run:

    # 1. Clone the repository
    git clone https://github.com/guimaraeslucas/axonasp.git

    # 2. Enter the directory
    cd axonasp

    # 3. Start services in detached mode
    docker-compose up -d

The container setup serves the `/www/` directory and exposes AxonASP through port `8801`.

## 2. Native build (without Docker)

For direct host execution, use Go 1.26+ and run the provided build scripts.

### Windows (PowerShell)

    .\build.ps1

### Linux and macOS (Bash)

    ./build.sh

## 3. Deployment architecture options

### Reverse proxy mode (`axonasp-http`)

Run AxonASP HTTP directly and put Nginx or Apache in front for TLS, static assets, and edge controls.

### FastCGI mode (`axonasp-fastcgi`)

Integrate directly with the web server through FastCGI for low-overhead ASP handling.

## 4. Nginx examples

### Option A: Reverse proxy on port 8801

    server {
        listen 80;
        server_name myapp.local;

        location ~* \.(jpg|jpeg|png|gif|ico|css|js)$ {
            root /var/www/axonasp/www;
        }

        location / {
            proxy_pass http://127.0.0.1:8801;
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
        }
    }

### Option B: FastCGI on port 9000

    server {
        listen 80;
        server_name myapp.local;
        root /var/www/axonasp/www;

        location ~ \.asp$ {
            include fastcgi_params;
            fastcgi_pass 127.0.0.1:9000;
            fastcgi_param SCRIPT_FILENAME
                $document_root$fastcgi_script_name;
        }
    }

## 5. Apache examples

### Option A: Reverse proxy

    <VirtualHost *:80>
        ServerName myapp.local
        DocumentRoot "/var/www/axonasp/www"

        ProxyPassMatch "^/(.*\.jpg|png|css|js)$" "!"

        ProxyPass / http://127.0.0.1:8801/
        ProxyPassReverse / http://127.0.0.1:8801/
    </VirtualHost>

### Option B: FastCGI with mod_proxy_fcgi

    <VirtualHost *:80>
        ServerName myapp.local
        DocumentRoot "/var/www/axonasp/www"

        <FilesMatch "\.asp$">
            SetHandler "proxy:fcgi://127.0.0.1:9000"
        </FilesMatch>
    </VirtualHost>

### Configuration is centralized and simple

Use `axonasp.toml` and optional `.env` values to manage ports, runtime behavior, and environment-specific overrides.

↓ Download Latest Release Open Configuration Docs