Upload an archive
Archive upload lets you deploy by providing a compressed file of your source code, without connecting a GitHub repository. Useful for one-off deploys, CI pipelines that produce artifacts, or projects where source control lives outside GitHub.
Supported formats
| Format | Extensions |
|---|---|
| ZIP | .zip |
| Gzip-compressed tar | .tar.gz, .tgz |
| Bzip2-compressed tar | .tar.bz2 |
Maximum file size: 500 MB.
Uploading during project creation
When creating a project, select Upload Archive as the source type. Drag and drop your archive file (or click to browse), then continue through the setup wizard.
Uploading for an existing project
To deploy a new version of an archive-based project:
- Go to Project → Source
- Upload a new archive file
- Click Save
- Go to Deployments and trigger a new deployment
Saving a new archive does not automatically trigger a deployment.
How it works
When you upload a file, Velumi:
- Transfers the file directly from your browser to Velumi's storage
- Verifies the file landed correctly and is within the size limit
- Stores the archive URL as the project's source
At build time, the archive is fetched and extracted. Your build command runs from the root of the extracted archive.
Limitations
- No branch or commit tracking — each upload is a snapshot
- No environment-level branch override; environment source overrides for archive projects let you upload a separate archive per environment
- Archive must contain the full source; Velumi does not merge or patch archives
- No automatic deployment on source code updates - updated code must manually be uploaded to Velumi