Provision an instance
A Fjord instance is a managed Forgejo server that Fjord runs for you, with the runners, Pages, and backups for its tier. You can own more than one, at different tiers, all under a single Fjord Account.
Provisioning is billed per instance by tier; there is no free tier. See Plans and billing.
Steps
- Sign in to the dashboard at fjord.sh.
- Choose provision a new instance and pick the tier you need. The tier sets storage, runner capacity, backups, and a few capability gates.
- Confirm. The instance is created and begins coming online.
What “coming online” looks like
A new instance moves through a short lifecycle, which the dashboard shows you in real time:
| State | Meaning |
|---|---|
requested | Your request is accepted and queued. |
provisioning | The server is being stood up and configured. |
ready | The forge is live and you can sign in to it. |
Provisioning is hands-off; you do not configure servers or DNS. When the instance is ready, the dashboard shows its URL and management controls.
After it’s ready
Once the instance is ready:
- Sign in to your forge and create your first repository. See Manage your instance.
- Point your runners and Actions, Pages, mobile app, and the
fjCLI at it. - Bringing code from elsewhere? See Migrate to Fjord.
Select the instance in the CLI with fj instances use <id-or-slug> so subsequent
commands route to it automatically.
Deleting an instance
You can delete an instance you own from the dashboard. Deletion tears down the server and its associated runners. Make sure you have exported anything you want to keep first; see Backups and restore.
- Stephen Way