vit667/vitamine

Vitamine is a self-hosted platform for running and deploying your own apps, similar in spirit to Heroku but kept entirely on your own machine. Nothing is sent to the cloud, so you install it, run it, and everything, from building your code to serving it, happens locally. Once running, you get a dashboard at localhost:3000 where you can watch build and runtime logs live, and each app you deploy gets its own address like app-name.localhost:8080. You can bring an app into Vitamine a few ways: point it at a Git repository URL and it will periodically check for new commits and redeploy automatically, push code directly the way you would with Heroku using git push, or copy in a local folder. Every deploy goes through a pipeline: fetch the code, detect what kind of app it is, install dependencies, build it, release it, then run a health check. If a deploy fails, Vitamine can automatically roll back to the previous working version, and you can also trigger a rollback yourself. Apps can run as plain Node processes or inside Docker containers, and Vitamine can also recognize purely static sites, like React or Vite builds, and serve them without needing a live process at all. Crashed apps restart automatically, up to five attempts, and Vitamine checks that ports are genuinely free before using them rather than trusting the operating system's records. For an app to work with Vitamine, it needs to listen on whatever port is handed to it through the PORT environment variable. If your project has a start script, Vitamine will run it, if it only has a static build folder, Vitamine serves that instead, and you can override install, build, or start commands per app if the defaults don't fit. The project is organized around a server that handles the API, deploy pipeline, git repositories, request routing, and app detection, alongside a React dashboard for the interface. It also ships a small example app to try things out with.