Website configuration
Manage your website settings, files, and deployment options.
Editing settings
- Go to your website's detail page
- Click Edit in the header
- Modify the settings you need
- Click Save
Configurable fields
| Field | Description | Editable |
|---|---|---|
| Plan | Hosting plan (starter, standard, pro) | Yes |
| PHP Version | PHP runtime version (PHP mode only) | Yes |
| Index Document | Default document to serve | Yes |
| Error Document | Custom error page | Yes |
| SPA Mode | Single-page application routing | Yes |
| Custom Domain | Domain attached via a gateway | Yes |
| Path Prefix | URL path prefix for the custom domain (e.g., /blog) | Yes |
| Git Sync | Repository sync configuration | Yes |
The website mode (static or PHP) and name cannot be changed after creation. To switch modes, delete the website and create a new one.
File management
The Files tab provides a built-in file manager for uploading and managing website content.
- Upload individual files or folders
- Browse the file tree
- Create directories
- View storage usage
Uploading files replaces existing files with the same name without confirmation.
File management via API
The Public API provides full file management capabilities:
# List files in the root directory
curl -H "X-Api-Key: $SAILOPS_API_KEY" \
https://app.sailops.io/api/public/api/v1/websites/my-site/files
# List files in a subdirectory
curl -H "X-Api-Key: $SAILOPS_API_KEY" \
"https://app.sailops.io/api/public/api/v1/websites/my-site/files?path=assets/"
# Get a presigned upload URL, then upload your file
UPLOAD_URL=$(curl -s -X POST \
-H "X-Api-Key: $SAILOPS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"path":"index.html","contentType":"text/html"}' \
https://app.sailops.io/api/public/api/v1/websites/my-site/files/upload-url | jq -r '.url')
curl -X PUT -T index.html "$UPLOAD_URL"
# Deploy a ZIP archive
curl -X POST -H "X-Api-Key: $SAILOPS_API_KEY" \
-F "[email protected]" \
https://app.sailops.io/api/public/api/v1/websites/my-site/files/deploy
# Delete a file
curl -X DELETE -H "X-Api-Key: $SAILOPS_API_KEY" \
"https://app.sailops.io/api/public/api/v1/websites/my-site/files?path=old-page.html"
# Get storage statistics
curl -H "X-Api-Key: $SAILOPS_API_KEY" \
https://app.sailops.io/api/public/api/v1/websites/my-site/files/stats
See the API Endpoints Reference for the full list of file management endpoints.
Git Sync
When Git Sync is enabled, content is automatically pulled from your repository.
Configuration
| Field | Description |
|---|---|
| Repository URL | HTTPS clone URL of the Git repository |
| Branch | Branch to pull from (default: main) |
| Path | Subdirectory within the repo to serve (default: /) |
| Access Token | Personal access token for private repositories (write-only, not displayed after save) |
Updating Git Sync via API
curl -X PATCH \
-H "X-Api-Key: $SAILOPS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"gitSync": {
"repoUrl": "https://github.com/user/site.git",
"branch": "production",
"path": "/dist"
}
}' \
https://app.sailops.io/api/public/api/v1/websites/my-site
Start and stop
You can stop a website to scale it to zero replicas and pause compute billing:
- Stop: Scales the website to 0 replicas. No compute charges while stopped. S3 storage charges still apply.
- Start: Restores the website to its plan's replica count.
Via the UI
Use the Start / Stop buttons in the website header.
Via the API
# Stop
curl -X POST -H "X-Api-Key: $SAILOPS_API_KEY" \
https://app.sailops.io/api/public/api/v1/websites/my-site/stop
# Start
curl -X POST -H "X-Api-Key: $SAILOPS_API_KEY" \
https://app.sailops.io/api/public/api/v1/websites/my-site/start
Observability
Overview tab
The overview tab displays:
- Current website status
- HTTP traffic charts: request rate, success rate, upstream response time, errors.
- Resource usage sparklines (CPU and memory)
Observability tab
Detailed metrics with time-range selection:
- HTTP traffic charts: request rate, success rate, upstream response time, errors.
- CPU and memory usage over time
Sums the website's Quick Expose and custom-domain routes across gateways; CDN edge cache hits are not included.
Logs tab
View real-time and historical website logs directly in the UI.
Custom domain via API
You can set or remove a custom domain programmatically:
# Set a custom domain with an optional path prefix
curl -X PUT \
-H "X-Api-Key: $SAILOPS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"domain": "www.example.com",
"gatewayName": "main-lb",
"pathPrefix": "/blog"
}' \
https://app.sailops.io/api/public/api/v1/websites/my-site/domain
# Remove the custom domain
curl -X DELETE -H "X-Api-Key: $SAILOPS_API_KEY" \
https://app.sailops.io/api/public/api/v1/websites/my-site/domain
The pathPrefix field is optional. When set, the website is served under that path on the domain (e.g., www.example.com/blog).