Deploy LibreFang

← deploy.librefang.ai

Recommended

Fly.io

Free forever, persistent storage

Easiest

Render

One-click OAuth deploy

Free tier: sleeps after 15 min, no persistent storage

Simple deploy with $5 free credit

Free forever (e2-micro), 30GB storage

One command, runs anywhere

docker run -p 4545:4545 ghcr.io/librefang/librefang

Install locally

Homebrew or download binary

brew install librefang/tap/librefang

Install script or download binary

curl -fsSL https://librefang.ai/install.sh | sh

PowerShell installer or .msi

irm https://librefang.ai/install.ps1 | iex

Free LLM included No API key needed 1 GB storage

A free LLM (Step 3.5 Flash via OpenRouter) is pre-configured. Your instance works out of the box — no API keys required.

1

Get a Fly.io API Token

Sign up or log in to Fly.io, then go to Personal Access Tokens and create a new token.

2

Paste and deploy

Your token is only sent to the Fly.io API and is never stored on our servers.

Fly.io API Token *

Verifying token...

Creating app...

Allocating IP addresses...

Creating persistent volume...

Launching machine with Step 3.5 Flash...

Deployed!

Your LibreFang instance is starting up (1-2 min).
Free LLM (Step 3.5 Flash) is pre-configured and ready to use.

Open Dashboard Fly.io Console

Troubleshooting

Cannot create Personal Access Token (SSO error)

If you see: "Access Tokens cannot be created because an organization requires SSO"
Use a per-org token instead. Run in your terminal:
flyctl tokens org <your-org-name>
Then paste the generated token above.

Deploy failed: image not found

The Docker image ghcr.io/librefang/librefang:latest is built on each release.
If no release has been published yet, use the terminal deploy script below — it builds from source.

How to add or change LLM provider after deploy?

flyctl secrets set OPENAI_API_KEY=sk-... --app your-app-name
Then edit /data/config.toml via flyctl ssh console to update the default model.

Or deploy from your terminal:

$ curl -sL https://raw.githubusercontent.com/librefang/librefang/main/deploy/fly/deploy.sh | bash