docs: add Railpack build type documentation

This commit is contained in:
Mauricio Siu 2025-03-05 00:59:57 -06:00
parent 259b4a5b09
commit c0bbe3b70c

View File

@ -13,8 +13,6 @@ Dokploy offers three distinct build types for deploying applications, each suite
This is the default build type in Dokploy. When you select Nixpacks, Dokploy builds your application as a Nixpack, which is optimized for ease of use and efficiency.
Nixpacks expose multiples variables to be configured via environment variables. All of these variables are prefixed with `NIXPACKS_`, you can define them in the `Environment Variables` tab.
| Variable | Description |
@ -44,6 +42,24 @@ Astro applications after you build it usually create a `dist` directory, so you
copy all the files in the `dist` directory to the root of your application, and will use a NGINX Optimized Dockerfile to run your application.
### Railpack (NEW)
Railpack is a new build type optimized and is the successor of Nixpacks.
Railpack exposes multiple Build Variables, you can define them in the `Environment Variables` tab.
| Name | Description |
| :-------------------- | :--------------------------------------------------------------------------------------------------------- |
| `BUILD_CMD` | Set the command to run for the build step. This overwrites any commands that come from providers |
| `START_CMD` | Set the command to run when the container starts |
| `PACKAGES` | Install additional Mise packages. In the format `pkg@version`. The latest version is used if not provided. |
| `BUILD_APT_PACKAGES` | Install additional Apt packages during build |
| `DEPLOY_APT_PACKAGES` | Install additional Apt packages in the final image |
you can read more about Railpack [here](https://railpack.com/config/environment-variables).
Railpack supports Nodejs, Python, Go, PHP, Go, StaticFile, Shell Scripts.
### Dockerfile
If your project includes a Dockerfile, you can specify its path. Dokploy will use this Dockerfile to build your application directly, giving you full control over the build environment and dependencies