50% off all plans, limited time. Starting at $2.48/mo
TrailBase

TrailBase

TrailBase is a single-file SQLite backend. Auth plus REST APIs plus realtime in a 30 MB binary, a fast PocketBase alternative. Apache 2.0 licensed, written in Rust, with an admin UI and JS hooks for custom server logic. Built for indie projects and prototypes.

Version

Latest

Operating System

Ubuntu Server 24.04 LTS

Min. RAM

1 GB

IP Types

IPV4,IPV6

Access

  • Open your browser and visit: https://<SERVER_IP>/_/admin
  • Self-signed SSL certificate is used, browser warning is expected.
  • Log in using the admin credentials stored on the server: /root/.cloudzy-creds
  • To view the credentials, run: /root/.cloudzy-creds

Important Files and Directories

  • Binary: /usr/local/bin/trail
  • Data directory: /var/lib/trailbase/traildepot
  • Service file: /etc/systemd/system/trailbase.service
  • Environment config: /etc/default/trail
  • Nginx config: /etc/nginx/sites-available/trailbase
  • Enabled site: /etc/nginx/sites-enabled/trailbase
  • SSL certificates: /etc/nginx/ssl/fullchain.pem, /etc/nginx/ssl/privkey.pem
  • Admin credentials: /root/.cloudzy-creds

Trail CLI Usage

Useful commands:

# Show all available commands
trail help

# Version
trail --version

# Start server (manual run)
trail run --help
trail --data-dir /var/lib/trailbase/traildepot run --address 127.0.0.1:4000

# Create user
trail --data-dir /var/lib/trailbase/traildepot user add <email> <password>

# Delete user
trail --data-dir /var/lib/trailbase/traildepot user delete <email>

# Change password
trail --data-dir /var/lib/trailbase/traildepot user change-password <email> <new-password>

# Change email
trail --data-dir /var/lib/trailbase/traildepot user change-email <old-email> <new-email>

# Admin commands
trail --data-dir /var/lib/trailbase/traildepot admin list
trail --data-dir /var/lib/trailbase/traildepot admin promote <email>
trail --data-dir /var/lib/trailbase/traildepot admin demote <email>

# Export OpenAPI definitions
trail openapi
  
# Components (WASM)
trail components list

Notes

  • Runs as a systemd service
  • Runs as non-root user (trailbase)
  • Bound internally to 127.0.0.1:4000 and exposed via Nginx HTTPS
  • Uses self-signed SSL
  • Some CLI commands require explicit --data-dir
  • You can stop the default instance and run a new one if needed: systemctl stop trailbase
  • Update Nginx if routing/port changes

More in Development Tools

Related apps.

Deploy TrailBase now. From $2.48/mo.