Deploy AxonASP fast, scale confidently
From proof-of-concept to production, AxonASP 2.1 provides practical deployment paths with Docker, native build scripts, reverse proxy mode, and FastCGI support.
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.