Release packages are built by .github/workflows/release.yml. Signing turns on once its
credentials are set in the repository (Settings → Secrets and variables → Actions). Until then
the packages are built unsigned:
- Windows SmartScreen warns about an unknown publisher.
- macOS Gatekeeper refuses to open the app until it is allowed in System Settings.
SignPath Foundation signs open-source projects for free, with a certificate issued to the foundation.
- Apply on signpath.org with the repository's URL. Once accepted, SignPath creates an organization and a project for Fern.
- Install the SignPath GitHub app on the repository. It lets SignPath verify that what it signs was built by this repository's workflow.
- In the SignPath project:
- Name the project
fern. - Keep the signing policies
test-signingandrelease-signing. Release signing waits for a manual approval in SignPath. - Add two artifact configurations:
windows-programs: a zip holding the PE filesfern.exeandfern-server.exe.windows-installer: a zip holding one PE file,*-setup.exe.
- Name the project
- In the GitHub repository:
- Add the variable
SIGNPATH_ORGANIZATION_ID. - Add the secret
SIGNPATH_API_TOKEN, a CI user's token from SignPath.
- Add the variable
The workflow first signs the programs, then builds the installer from them, and finally signs the installer.
This needs the Apple Developer Program (99 USD a year).
- Create a "Developer ID Application" certificate and export it with its private key as a
.p12file. - Create an app-specific password for your Apple ID at appleid.apple.com.
- Add these repository secrets:
| Secret | Value |
|---|---|
APPLE_CERTIFICATE |
the .p12 file, base64-encoded (base64 -i cert.p12) |
APPLE_CERTIFICATE_PASSWORD |
the .p12 file's password |
APPLE_SIGNING_IDENTITY |
e.g. Developer ID Application: Your Name (TEAMID) |
APPLE_ID |
the Apple ID's email |
APPLE_TEAM_ID |
the ten-character team ID |
APPLE_APP_PASSWORD |
the app-specific password |
script/package then:
- signs
Fern.appwith the hardened runtime; - signs the DMG;
- sends the DMG to Apple for notarization;
- staples the ticket to the DMG, so it opens without a warning even offline.
This policy applies to signed Windows releases.
- Free code signing is provided by SignPath.io, with a certificate by SignPath Foundation.
- Authors (committers): Amin Atabiev.
- Reviewers, who review every outside contribution before it is merged: Amin Atabiev.
- Approvers, who approve every signing request: Amin Atabiev.
- Everyone in these roles uses multi-factor authentication on GitHub and SignPath.
- Signed programs carry their product name and version in their file properties.
- Fern can be removed completely: the installer comes with an uninstaller, and the data folder is listed in Settings → Data & Sync.
Only binaries built by this repository's GitHub Actions from its own source are signed.
Privacy. Fern does not send any data anywhere. It collects no telemetry and needs no account. Data leaves the computer only if you set up sync, and then it goes only to the server you choose.