Deploy from git

Use a Tokay hosted git repository when you want local development and git push to be the deployment path. After the first connection, the repository stays in your normal git workflow and Tokay prepares updates as pushes arrive.

Last updated July 13, 2026

Create or choose the repository

Open New Service, choose Deploy from Git, then create a repository or select one you already have in the Workspace.

Add an SSH key or create a git token before the first push. The same credential works across repositories where your account has access. See SSH keys and git tokens for choosing between them.

Push the code

The setup page provides the repository URL and exact commands. A new local repository usually needs the following shape.

git remote add tokay <your-repo-url>
git add .
git commit -m "Initial commit"
git push tokay

Tokay analyzes the pushed source and lists the Services it can deploy. One repository can contain several Services, such as a web app and a scheduled job.

Review the detected configuration, choose the Service you want, and deploy it. If Tokay does not find a runnable Service, add or clarify an entry point in the repository and push another commit. Tokay analyzes the new push automatically.

Later pushes update the same Services

Each push starts analysis and prepares the affected Services. The Project setting decides whether an update deploys automatically or waits for Update.

The repository page shows detected Services, existing deployments, and candidates that have not been deployed yet. Use that page to add a second Service from the same repository.

Git is the editable home

The dashboard source view is read only for git managed code. Make changes in a local checkout, then commit and push them. This prevents browser edits and git history from creating competing versions.

Every push goes through review before deployment. New requirements, hardcoded credentials, and build problems surface before the running version changes.