develop.mdwn

[[!meta title="Developing Webconverger"]]

• Report and view bugs
• [[Core_concepts|design]]
• Webconverger Debian Live configuration
• Webconverger daily builds
• [[Webconverger_in_your_locale|i18n]]
• [[Artwork]]
• [[Firefox_extension_development|Kiosk]]
• Debian Live project and Live helper packages
• [[Howto_add_Java|Java]]
• [[Howto_integrate_nvidia_drivers|nvidia]]
• [[Customising_cronjob|cronjob]]
• [[Debug_mode|debug]]
• [[Using_PXEBOOT_for_deployment|pxeboot]]

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

We might be the first distribution to use git for [[upgrades|upgrade]] and managing just about everything we do. :)

The Webconverger distribution is an MIT licensed production (notable exceptions are non-free wireless firmware and [[flash|adobe]]). 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 with a Docker image

Follow the README for tips how to build and run the Dockerfile, which we use for building Webconverger in the Debian environment.

WEBC_CHECKOUT environment variable should be the clone of https://github.com/Webconverger/webc. Though you could try get away with a shallow clone (~2GB versus ~6GB for full) to save bandwidth and disk space, e.g. git clone --depth 1 https://github.com/Webconverger/webc.git but it's not guaranteed to work!

For tweaks, take a look at auto/config.

make is run from within the Docker container to build the ISO image, which is named live-image-i386.hybrid.iso by default.

Next use this [[testing_guide|testing]] on your freshly built image.

To work within the chroot, you shouldn't require the Docker image. chroot should be sufficient:

alias c="sudo chroot $WEBC_CHECKOUT env -i PATH=/bin:/usr/bin:/sbin:/usr/sbin /bin/bash"

Typical work as you can see from the commits is keeping the distro upto date with the latest packages.

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|acknowledgements]] contributions!

Tips for getting your patch out a running Webconverger

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

• Submit a bug report