Vilice
To Help You Host Your Own Applications
Vilice is a self-hosting tool that records every state-changing action to a hash-chained log before running it.
Yet Another Hosting Tool?
Vilice was built with the goal of making web application hosting boring and durable. Despite its name, it is not meant to be fancy, but rather safe and predictable. Vilice is also free and open source. While built with purpose, it was built primarily with Anthropic Claude LLM vibes — so use it at your own risk. Report concerns and submit contributions to help improve it.
Current versionv0.4.4
Install Vilice:
curl -fsSL https://get.vilice.org/install.sh | sudo bash -s -- 0.4.4
Set Up a Box
Three steps turn a fresh Ubuntu box into one Vilice runs. Each command has its own page.
Harden it — optional, and first. Key-only SSH, a firewall with only the SSH port open, and automatic security updates. Log in with a key, not a password, before you run it.
sudo vilice harden
Prepare it — required. Say what the box is for: a host runs apps, a balancer fronts
other boxes. See Roles.
sudo vilice prepare host
Admit a key. Everything past here runs as the _vilice account, not root. Authorize
whoever will operate the box — Vilice Console, a CI job, your own script — by name, at a
scope:
sudo -u _vilice vilice authorize "ssh-ed25519 AAAA… console" --client console --scope operate
From there, every deploy arrives over that scoped key. The next thing you need is an AppConfig.
Upgrading
There is no upgrade command. Run the install line with the newer version, then prepare
again with the box’s role — it approves the new binary, and until it runs Vilice refuses
to act. Your apps keep running throughout.
curl -fsSL https://get.vilice.org/install.sh | sudo bash -s -- 0.4.4 && sudo vilice prepare host
Part of Vilice’s reliability is its controlled access plane: every command is gated by a scoped SSH key, and every action that changes the box is written to a hash-chained log on the machine — before it is executed, so nothing happens off the books. Security starts by locking down a fresh Ubuntu box with standard commands and tooling, and then preparing that machine for its purpose as an app host or a load balancer.
That holds because no key gets a shell. Vilice is the accountable control plane, not your admin access — you still reach the box as yourself, and it sits alongside the tools you already use rather than replacing them. See Not Your Admin Access.
Dependencies
Tools Vilice Builds On
Vilice writes almost none of this itself. It is a gate and a scribe, and the work is done by open source tools that already do it well:
- OpenSSH — the access plane. The key is the identity and the forced command is its scope. No key gets a shell.
- systemd — residency. Apps are ordinary units and a timer keeps the record ticking, so Vilice needs no daemon of its own.
- Podman — rootless containers, run as Quadlet units under systemd.
- Caddy — hostname routing and automatic HTTPS.
- restic — encrypted, deduplicated backups to a repo you own.
- UFW — the firewall: deny inbound, and open only what the box’s role serves.
- fail2ban — bans repeated SSH authentication failures.
- unattended-upgrades — automatic security patching, on a schedule you can see.
Everything they write is their own plain config file, readable by an admin who has never heard of Vilice — and left in place if Vilice is removed.
Inspiration
Other Self-Hosting Tools
Kamal (and Once) were the inspiration that led to the creation of Vilice. The reliability of Linux, the ever-worsening-doom-loop of big name tech, cloud price-gauging, and new tools that made deployment within reach to the average developer, all combined to make the actual computer seem a lot less scary. However, there are a lot of other great self-hosting tools out there that may be better for your specific needs.
- Kamal — zero-downtime deploys of web apps anywhere, over Docker: rolling restarts, remote builds, and accessory services.
- Dokku — an open-source PaaS alternative to Heroku, and the smallest such implementation around.
- Coolify — self-hosting with superpowers: an open-source alternative to Vercel, Heroku, Netlify and Railway, with hundreds of one-click services.
- CapRover — a scalable, free, self-hosted PaaS that keeps your infrastructure fully under your control.
- Cloudron — a complete solution for running apps on your own server; self-hosting made simpler.
- YunoHost — a system that installs itself on a server so you can run and maintain your own digital services with very little technical knowledge.