Skip to main content
Deploy a project from the Pxxl dashboard. Choose where your code lives, review the settings Pxxl finds, and follow the deployment log until your URL is ready.
You need a Pxxl account. For GitHub, install the Pxxl GitHub App and give it access to the repositories you want to deploy. Some source options require a paid plan.
1

Open Deploy

Sign in at pxxl.app, open the dashboard, and choose Deploy. The flow keeps source selection, configuration, and logs on one page.
2

Choose a source

Select GitHub, GitLab, Pxxl Drop, a Docker source, a template, or an imported project. The next step changes to match the source you chose.
3

Select the project

Choose a repository, upload the source, enter an image, or choose a template. For Git sources, select the branch and let Pxxl inspect the repository before you continue.
4

Review the configuration

Pxxl fills in the detected language, framework, package manager, base directory, and commands. Check the project name, environment, domain, port, environment variables, services, and optional resource settings. You can edit the detected values before deploying.
5

Deploy and follow the log

Submit the deployment. Pxxl queues the work, shows the build output in the same flow, and finishes by publishing the project route. Open the URL when the status changes to deployed.

​
Deployment sources

​
What to check

​
Web services

Your server should listen on $PORT and bind to 0.0.0.0. Pxxl uses the port and start command from the review step to check the service before publishing its route.

​
Static Apps

Static Apps do not need a running server. A plain static repository needs an index.html or index.htm in the selected base directory. PHP projects use the PHP runtime instead. A built frontend needs to produce its static output during the build. Read Project Types for the difference between a Web Service and a Static App.

​
Monorepos

Set the base directory to the folder that contains the service. For a repository with more than one deployable directory, follow Multiple Services and Monorepos to configure separate aliases, ports, commands, and routes.

​
After you submit

Pxxl records the deployment, chooses a build server, and streams the task log to the dashboard. A Web Service is checked for health before its route is published. A Static App is uploaded to Pxxl Edge and served without a runtime container.

​
Next steps