Paramètres de déploiement

Turtleship hosting is zero-config: you pick where your app runs, and Turtleship detects how to build it, sets up the infrastructure (app, database, domain) and keeps an eye on every deploy. The settings live under Project Settings → Hosting & deployment.

Deploy Mode

Managed (default)

Your app runs on Turtleship's own hosting platform. No configuration needed — we detect your stack, build it, provision a database when your app needs one, and give each environment its own URL.

None

Opt out of hosting. Turtleship develops your app but does not deploy it.

Custom (Enterprise)

Bring your own Coolify environment: you provide the base URL, an API token and a server, and Turtleship provisions and deploys onto your infrastructure. Custom domains are available in this mode.

To let your Coolify clone a private repository, add the matching git source in the hosting settings: a GitHub App UUID for a private GitHub repo, or a deploy key UUID for a private GitLab repo (or any other non-GitHub source). Configure the key once in your Coolify under Keys & Tokens → Private Keys and register its public key as a deploy key on the repository.

Environments

Each project gets up to two hosted environments:

• Staging — the test environment; every approved merge lands here first
• Production — your live app; updated when you approve a release

Press Deploy on an environment card to set it up. You can follow the progress live (project → database → app → variables → domain → first deploy).

Build Detection

Turtleship inspects your repository and decides how to build it automatically: an existing Dockerfile or docker-compose is used as-is; recognised stacks (such as Next.js or Node) get a generated build recipe — without writing anything to your repository.

Environment Variables

Manage variables and secrets per environment under Manage environment → Environment variables. Values are stored encrypted; secrets are masked and changes are pushed to the running environment automatically.

Day-2 Operations

Under Manage environment you can also:

• View logs — the app's recent runtime logs
• Restart / Stop — control the running app
• Redeploy — rebuild and deploy the current version
• Version history & rollback — see recent builds and put an earlier version back live (see the Rollbacks guide)

Database & Backups

When your app needs a database, Turtleship provisions a PostgreSQL instance and wires the connection string into your app automatically. Backup schedules are configured once in the hosting dashboard; until then the environment shows a backup warning that you can re-check after configuring it.

Notifications

You automatically get in-app notifications (and email for failures) when:

• a deploy fails or times out
• the live version differs from the expected version
• your app goes offline — and again when it recovers