Development

Want to help make TurnKey even better? Get involved and help nudge the project in the direction you are interested in. That's what open source is all about!

Blueprints and development wiki

We use Launchpad blueprints to plan and track development of new features. If you have a good idea for a new feature or appliance that isn't already in the works, create a new blueprint!

We use a public development wiki as our shared whiteboard for discussing TurnKey Linux development.

Bug reporting and triaging

If you find a bug, report it on our bugtracker. Better yet fix it and share your results. It also helps if you can help reproduce and isolate a bug. Confirmed bugs get fixed sooner.

Customize an existing appliance or develop a new one

TurnKey is designed to be easy to build on using TKLPatch, a simple customization mechanism.

Example customizations include updating a configuration file, adding data files, adding a package and even creating a brand new appliance leveraging a generic appliance such as Core, LAMP, Rails, etc.

You are free to develop TurnKey appliances for private use, but we encourage everyone to share their results with the community. That way we can harness contributions to improve future versions of TurnKey.

Once we add a new appliance to the project we assume the burden of maintaining it at the appliance level with regular updates. This frees you to focus on more interesting tasks (e.g., improving quality of integration, software sub-components).

Custom packages and source code

Any custom package that isn't taken straight from Ubuntu's repositories can be found at our mini-repository at archive.turnkeylinux.org.

The source code to all custom components can be found at code.turnkeylinux.org. Some components are also hosted on github.