Developing Webconverger

Report and view bugs
Core concepts
Webconverger Debian Live configuration
Official Webconverger package repository
Webconverger daily builds - build script sources
Webconverger in your locale
Artwork
Firefox extension development
Debian Live project and Live helper packages
Howto add Java
Howto integrate nvidia drivers
Customising cronjob
Debug mode
Using PXEBOOT for deployment
Webconverger uses Progress (Artax) backports

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 opensource (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.

Building on a Debian system:

Building an image from scratch is usually only necessary if you need to customise the image's packages. 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!

Download and install the latest live-build from the Debian Unstable repository.
git clone git://github.com/Webconverger/Debian-Live-config.git
cd Debian-Live-config/webconverger/
Take a long good look at auto/config
make

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

It is recommend you build from a chroot and invest some time to setup your development environment.

Next use this testing guide on your freshly built image.

Please share your forks on github! Contributions must be MIT licensed.

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
0001-Upgrade-service.patch
root@webconverger:~# cat 0001-Upgrade-service.patch | p
http://ix.io/41O

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

If your build doesn't work

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