TURNKEYGNU / LINUX
English

Ready-to-use server

TKLDev

TurnKey Development Toolchain and Build System

Developer toolsSDKSpecials
TKLDev - chroot coreTKLDev - chroot core TKLDev - make coreTKLDev - make core TKLDev - appliance listTKLDev - appliance list

TKLDev is the mother of all TurnKey apps. It's used to give birth to all TurnKey apps, including new versions of itself. It's designed to make simple things simple, and hard things possible. It's a self-contained build system that can be used to rapidly prototype and repeatably build any generic Debian-based Linux distribution or TurnKey GNU/Linux system from source.

To get started read the documentation. Read the blog post announcing TKLDev for the background story.

This appliance includes all the standard features in TurnKey Core, and on top of that:

  • Includes a fast copy-on-write build toolchain based on GNU make, fab, and deck.

  • Turnkey development directory structure with preconfigured CDPATH.

  • Integrated caching proxy (squid) for fast and iterative development.

  • Full usage and development documentation.

Example build sources

  • TurnKey GNU/Linux apps <https://github.com/turnkeylinux-apps>

  • Community developed distributions <https://github.com/turnkeylinux/tracker/issues?labels=new-appliance>

Credentials (passwords set at first boot)

  • SSH: username root

Usage details & Logging in for Administration

No default passwords: For security reasons there are no default passwords. All passwords are set at system initialization time.

Ignore SSL browser warning: browsers don't like self-signed SSL certificates, but this is the only kind that can be generated automatically. If you have a domain configured, then via Confconsole Advanced menu, you can generate free Let's Encypt SSL/TLS certificates.

Web - point your browser at either:

  1. http://12.34.56.789/ - not encrypted so no browser warning
  2. https://12.34.56.789/ - encrypted with self-signed SSL certificate

Note: some appliances auto direct http to https.

Username for OS system administration:

Login as root except on AWS marketplace which uses username admin.

  1. Point your browser to:
  2. Login with SSH client:
    ssh root@12.34.56.789

    Special case for AWS marketplace:

    ssh admin@12.34.56.789

* Replace 12.34.56.789 with a valid IP or hostname.

Documentation

TKLDev - Build Custom ISOs from source

TKLDev is Turnkey Linux's appliance build engine. It's what TKL devs use to build all the appliances! Use it to build any of the TurnKey library from source or create your own.

TKLDev allows you to develop custom appliances which you can distribute. If your appliance contains only free open source software, let us know. Maybe we can include it in the official library!

Links: Documentation & Info

TKLDev Appliance page - info about the TKLDev appliance, inc download links.

TKLDev Announcement - Blog post - Getting a bit dated now, but still includes useful info and documentation. Useful for background and base knowledge of TKLDev.

How to build a TKL ISO from source (using TKLDev - Blog post). A step-by-step tutorial (with screenshots) on how to build a Core ISO from source code. [update] The content has been copied to our docs and updated.

Full TKLDev Docs (GitHub) - The full (and current) documentation of TKLDev (hosted on GitHub as part of the TKLDev repo). Covers using TKLDev; start to finish. Extensive and accessible; a big read but worth the effort.

Build a new appliance with TKLDev - My personal workflow and something of a 'getting started' building a new appliance type doc. I essentially wrote this for those that wanted an overview of a potential workflow. It is also suitable for those that are too impatient to read the full docs and want to jump right in . Don't blame me if it doesn't work though! :-p

TKLDev issues and feature requests (on the TurnKey issue tracker - hosted on GitHub). Note that by default, all issues (open and closed) are displayed, they can easily be filtered via the relevant ("open"/"closed") links just above the list.

Forum posts tagged 'tkldev' - Find additional info and/or hints.