Sign up and deploy
This walks through everything from a brand-new account to a deployed .NET app serving HTTPS traffic at a real URL. About five minutes if your app builds cleanly.
1. Create an account
Head to velixir.net/account/register. Email + password, or one-click sign-in with GitHub or Google. We send a verification link; click it to activate.
Every new account starts with €10 of free credit. That's enough to run a single small app for the first month while you kick the tyres — you only need to add a card if you want to keep going past the credit, or if you create resources that exceed what the free credit covers.
2. Top up (optional, when you're ready)
From the dashboard, click Billing in the sidebar, then Add funds. We use Stripe — you'll never see a card form on a Velixir page. Top-ups are non-refundable but never expire.
3. Create a project
Projects are how you group apps, databases, and caches that go together — usually one project per product. From the dashboard click + New Project, name it, and pick a region (the closest one to your users).
4. Create an app
Inside your project, click + New App. You'll choose:
- A name (becomes part of the URL:
<your-app>-<region>.velixir.run) - A plan (CPU + memory + disk; you can change this later without redeploying)
- The .NET version your app targets (
net9.0,net8.0, etc.) - Optional: a Git repository URL if you want to wire up the GitHub webhook later
We auto-deploy a "Hello World" placeholder so the URL works immediately, even before you've pushed your own code.
5. Deploy your code
Two paths:
Path A — Use the CLI (recommended)
# Inside your .NET project directory
velixir login
velixir init --app <your-app-id>
velixir deploy
velixir deploy builds, packages, and uploads your app in one shot. The full walkthrough is on the Deploying page.
Path B — Upload from the dashboard
On the app's Overview page, click Upload artifact. Pick a .zip or .tar.gz of your dotnet publish output. The upload goes straight to object storage (your browser, no proxy hop) and the deploy kicks off as soon as it lands.
6. Watch it deploy
The app's Overview tab updates live: build status, replica count, request rate. A deploy usually takes 30–60 seconds from upload to first byte served.
Hit the URL in the header (<your-app>-<region>.velixir.run) and you should see your app responding.
Next
- Environment variables — Wire up
DATABASE_URL, secrets, feature flags. - Custom domains — Replace the
*.velixir.runURL with your own. - Scaling and HA — Turn on autoscaling, add a warm-standby replica in a second region.