Deploy Your First App from Git
QuickStack clones your repo, builds the Docker image from your Dockerfile, and runs it as a container. Every time you click Deploy, the current configuration is applied — changes to settings do not take effect automatically.
Prerequisites
- QuickStack installed (installation guide)
- A Git repository with a valid
Dockerfile
Required inputs
| Field | Required | Description |
|---|---|---|
| Repo URL | Yes | HTTPS URL (e.g. https://github.com/org/repo.git) |
| Branch | Yes | Branch to build from (e.g. main) |
| Dockerfile path | Yes | Relative path from repo root (e.g. ./Dockerfile) |
| Git Username + Token | No | Required for private repositories |
Step 1: Create project and app
- On the dashboard, click Create Project and give it a name.
- Open the project, click Create App → Empty App, give your app a name.
Step 2: Configure Git source
- Open the app and go to App Settings → General tab.
- Set Source type to Git Repository.
- Fill in: Repo URL, Branch, Dockerfile path.
- For private repos: add Git username and Personal Access Token.
- Click Save.
Step 3: Deploy
Click the Deploy button at the top of the page. This triggers a fresh build from your Git branch and deploys the resulting container.
Deploy applies changes
Any configuration change — Git source, env vars, storage, domains — only takes effect after clicking Deploy.
Step 4: Verify
- Open the Overview tab — status turns green when the app is running.
- Click Show Logs on the current deployment to inspect build and startup output in real time.
Troubleshooting
| Symptom | Fix |
|---|---|
| Build fails | Check deployment logs for Dockerfile errors |
| Dockerfile not found | Verify the path is relative to repo root (e.g. ./Dockerfile) |
| App not reachable after deploy | Add a domain in the Domains tab with the correct internal container port |