Skip to main content

Deploy Your First Application

Use QuikDB Compute to deploy an application from GitHub or an uploaded .tar.gz/.zip archive.

1. Choose the source​

Open compute.quikdb.com. Choose Connect GitHub & deploy and approve only the repositories you want QuikDB to read, or choose Deploy an application archive.

2. Select the application​

Select the repository, branch and service directory. For a monorepo, confirm the directory that contains the application and its build files. For an archive, select a .tar.gz or .zip no larger than the displayed limit and put application files at its root.

3. Review the configuration​

Check the detected runtime, build command, start command and port. QuikDB uses an existing quikdb.json, Dockerfile or supported detected project configuration. Detection is a starting point, so correct anything that does not match the repository.

Add required values in the deployment Environment settings. Do not commit production secrets or paste them into support chat.

For plain HTML/CSS/JavaScript, select Static Site. Put index.html at the selected source root and choose whether missing routes return 404 or fall back to index.html for an SPA. See Deploy a Static Site.

4. Deploy and watch the logs​

Start the deployment and open its detail page. Build logs explain dependency or compilation failures. Runtime logs show startup and application errors. Your application must listen on the PORT value supplied by QuikDB.

Common states are pending, building, deploying, queued, live, failed, stopped and sleeping. A queued deployment waits for qualifying capacity; a failed deployment needs a source, configuration, build or health-check correction.

5. Add the services you need​

After the application is live, you can:

For more detail, read Deploying Your App.