#Getting Started

New to Fjord? This is the path from nothing to a running instance with your code pushed and CI green. It takes a few minutes, and most of it happens in the browser.

#1. Create a Fjord Account

Sign up at fjord.sh. A Fjord Account is the platform credential you use across the web dashboard, the mobile app, and the fj CLI; it is separate from any individual Forgejo instance.

After you sign up, Fjord emails you a verification link. Confirm it before you provision, an unverified account cannot create an instance.

#2. Provision your instance

From the dashboard, provision a managed Forgejo instance. Fjord stands up a sovereign, single-tenant forge for you and marks it ready once it is live and reachable. See Provisioning for tiers, regions, and what each state means.

#3. Sign in to your forge

Once the instance is ready, sign in with your Fjord Account:

• Web: open the instance URL from the dashboard.
• CLI: fj auth login, then work from any clone. See fj auth.
• Mobile: open Fjord Mobile and pick your Fjord Account.

#4. Push a repository

Create a repository in the forge (the web UI, or fj repo create), then push your code to it like any git remote:

git remote add origin https://<your-instance>/<you>/<repo>.git
git push -u origin main

Your instance speaks standard Git and the Forgejo API, so existing git workflows and tooling just work.

#5. Run your first CI build

CI runs on Forgejo Actions. Every instance runs on the shared Linux runner pool, so there is nothing to install, commit a workflow and it runs. On Team and Pro you can add dedicated runners as a paid add-on when you want capacity that is yours alone. Add .forgejo/workflows/ci.yml:

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: https://rasterhub.com/rasterstate/setup-node-action@v1
        with:
          node-version: '20'
      - uses: https://rasterhub.com/rasterstate/setup-pnpm-action@v1
      - run: pnpm install --frozen-lockfile
      - run: pnpm test

Fjord Actions are drop-in replacements for the GitHub-hosted actions a Forgejo runner can’t reach; reference them by full URL so the runner clones them from rasterhub.com instead of github.com. setup-node-action installs Node and setup-pnpm-action installs pnpm at the version declared in your package.json. Neither talks to github.com, and neither needs a PAT.

Push the workflow and watch it from the forge’s Actions tab or fj run list.

#What’s next

• Actions overview covers the full bundle: cache, artifacts, language toolchains, Docker, and repo automation.
• Platform overview shows how instances, tiers, runners, and backups fit together.
• Pages overview shows how to publish a static site, like this one, straight from a workflow.