Skip to content

Showcases how it is possible to host a F-Droid repo on a static site hosting service like GitHub Pages

License

Notifications You must be signed in to change notification settings

litetex/fdroid-pages

Repository files navigation

fdroid-pages

Showcases how it's possible to provide an F-Droid repo on a static site hosting service like GitHub Pages.

It currently is configured to contain NewPipe-nightly and NewPipe-refactor-nightly.

Open https://litetex.github.io/fdroid-pages for a live demo.

Initial setup

Important

If you want to create your own repo and use this repo as a base, make sure to remove/customize all assets like images, links and names!

You need a few secrets that are used for verifying the repo.

To generate these you have to run the fdroid-repo-generator-Docker image offline.

  1. Ensure that you have Docker installed
  2. Checkout the repo and open in your terminal
  3. Select the directory fdroid-repo-generator using cd fdroid-repo-generator
  4. Build the image offline: docker build --tag fdroid-repo-generator . (the dot at the end is important)
  5. Launch the container docker run --rm -it --entrypoint=/bin/bash -v %cd%/temp-repo:/repo -w /repo fdroid-repo-generator
    • This will create a new directory temp-repo, if this is already present you may need to clean it
    • After the container is launched a console should be visible
  6. Execute fdroid init to initialize the repo
  7. When this is done exit the container with typing exit

You now should have a fresh F-Droid repo initialized in temp-repo.

Now we need to get the following secrets and store them in GitHub Action secrets:

What? Secret name Notes
keystore.p12 KEYSTORE_BASE64 Needs to be converted to base64.
Easiest way: cat keystore.p12 | base64 > keystore_b64.txt
config.ymlrepo_keyalias REPO_KEYALIAS
config.ymlkeystorepass or keypass (identical) KEYPASS keystorepass and keypass are usually identical
config.ymlkeydname KEYDNAME

Updating

Updates are checked for every night using GitHub Actions. If an update is found, the repo is rebuilt.

Mirroring

This example uses mirroring to Codeberg.

The mirrored Codeberg site is available at: https://litetex.codeberg.page/fdroid-pages

Similar projects

About

Showcases how it is possible to host a F-Droid repo on a static site hosting service like GitHub Pages

Topics

Resources

License

Security policy

Stars

Watchers

Forks