Michael BiancoandGitHub
2750ff6b8e
* docs: document remote Docker and BuildKit setup for local development Generated-by: aiautocommit * chore: ignore local mise configuration file Generated-by: aiautocommit * docs(guides): explain why to use a remote Docker host Generated-by: aiautocommit * docs(config): update environment variables documentation - Document how Railpack reads environment variables from its process environment - Relocate and update description for `RAILPACK_DISABLE_CACHES` - Fix table formatting and minor phrasing Generated-by: aiautocommit * docs: clarify remote docker host guide for local development Generated-by: aiautocommit * docs: update BuildKit setup instructions to use docker command Generated-by: aiautocommit
Railpack
Railpack is a tool for building images from source code with minimal configuration. It is the successor to Nixpacks and incorporates many of the learnings from running Nixpacks in production at Railway for several years.
Getting Started
# Install mise & railpack
curl -sSL https://mise.run | sh
mise install github:railwayapp/railpack@latest
# start BuildKit container & let railpack know about it
docker run --rm --privileged -d --name buildkit moby/buildkit
export BUILDKIT_HOST='docker-container://buildkit'
# create a Next.js app
npm create next-app@latest my-app
cd my-app
# build and run the app!
railpack build .
docker run -p 3000:3000 -it my-app
Railpack automatically detects the project type (Next.js, in this case, but many languages & frameworks are supported!) and generates an optimized container image.
Note: The above steps are for running Railpack locally to experiment and test. If you deploy on Railway, Railpack runs automatically when you push changes to your repository.
Documentation
Full documentation for both operators (platforms, like Railway) and users (developers using Railpack to build their applications) is available at railpack.com.
Contributing
Railpack is open source and open to contributions. See the CONTRIBUTING.md file for more information.