Skip to main content

Website configuration

Manage your website settings, files, and deployment options.

Editing settings​

  1. Go to your website's detail page
  2. Click Edit in the header
  3. Modify the settings you need
  4. Click Save

Configurable fields​

FieldDescriptionEditable
PlanHosting plan (starter, standard, pro)Yes
PHP VersionPHP runtime version (PHP mode only)Yes
Index DocumentDefault document to serveYes
Error DocumentCustom error pageYes
SPA ModeSingle-page application routingYes
Custom DomainDomain attached via a gatewayYes
Path PrefixURL path prefix for the custom domain (e.g., /blog)Yes
Git SyncRepository sync configurationYes
info

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
warning

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​

FieldDescription
Repository URLHTTPS clone URL of the Git repository
BranchBranch to pull from (default: main)
PathSubdirectory within the repo to serve (default: /)
Access TokenPersonal 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).