Skip to content

LundiNord/fdroid-pages

 
 

Repository files navigation

fdroid-pages

Open https://fdroid.nyxnord.de/fdroid/repo/ to see the repo.

Using this repo as a template

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. Check out the repo and open it 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.

The next step is 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.

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

Contributors

Languages

  • Dockerfile 60.9%
  • Shell 39.1%