If you are new to the project, Welcome!! Please start out by testing.

We like to think we are pretty innovative how we use git for upgrades and managing just about everything we do. :)

The Webconverger distribution is an MIT licensed production (notable exceptions are non-free wireless firmware and flash). You must understand that the branding (logo and the name "Webconverger") are proprietary. Only Webconverger built images should display the logo and can be sold as "Webconverger". Thank you.

Build on a stable Debian system:

Building an image from scratch is usually only necessary if you need to customise the image's rootfs. The boot API should be sufficient for most of your needs.

This is the developer supported way of building the Webconverger image. Please do not ask webc-users how to customise Webconverger any other way to avoid paying for the configuration service that funds this project. Thank you!

  1. Download live-build 4.x from Debian Stable. You may need extra packages like xorriso and setup ln -s /usr/lib/ISOLINUX/ /usr/share/

  2. git clone git://github.com/Webconverger/Debian-Live-config.git

  3. cd Debian-Live-config/webconverger/
  4. Take a look at auto/config
  5. make

These steps are formalised in the daily build process's webc-build.sh.

Next use this testing guide on your freshly built image.

Please share your forks on github! :) Contributions must be MIT licensed. For patches to be accepted, you must agree to transfer copyright to Webconverger (the company) to make things manageable. We do acknowledge contributions!

Tips for getting your patch out

In debug mode:

root@webconverger:/etc/systemd/system# git status | less
root@webconverger:/etc/systemd/system# git commit
[systemd fa18ba0] Upgrade service
 create mode 120000 etc/systemd/system/multi-user.target.wants/upgrade.service
 create mode 120000 etc/systemd/system/upgrade.service
 create mode 100644 lib/systemd/system/upgrade.service
root@webconverger:~# git format-patch HEAD~1
root@webconverger:~# cat 0001-Upgrade-service.patch | p

And provide the link http://ix.io/41O in a bug report! :)

If your build doesn't work

  1. Check with the latest daily build logs. Compare them.
  2. Check for bugs with Debian Live
  3. Submit a bug report

SYSLINUX (the sane boot loader) paths have changed again and again through different Debian releases annoyingly. You might need to setup some paths to make sure live-build doesn't fail.