Introduction to TuCloud

What is TuCloud?

TuCloud is a hosting and continuous deployment platform. Each account manages projects, deployments, domains, email, variables, security, and usage from the dashboard.

Repositories connect through a GitHub App. TuCloud installs a workflow on the selected branch, builds with GitHub Actions, and activates an immutable release in the corresponding hosting account.

Workflow

1. 1
   Connect GitHub

   Authorize the GitHub App and choose which repositories TuCloud can access.

2. 2
   Import a project

   Select a repository, production branch, runtime, and permanent subdomain.

3. 3
   Deploy

   A push or manual run starts the TuCloud workflow in GitHub Actions.

4. 4
   Operate

   Review status, logs, health, usage, domains, TLS, and firewall rules in the dashboard.

Isolation and security

• Every project belongs to the authenticated user and an active hosting account.
• Secrets are encrypted with AES-256-GCM before storage, and the API never returns their values.
• GitHub Actions uploads are validated with OIDC and a project-scoped token.
• The Host Agent listens on loopback and validates identity, quota, paths, and files before activating a release.