TurnKey Core - Common Base for All Appliances
Makefile Shell
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.

README.rst

TurnKey Core - Debian GNU/Linux with Batteries Included

TurnKey Core is the base operating system which all TurnKey GNU/Linux solutions share in common. It is commonly deployed standalone as a convenient starting point for custom system integrations. Benefits include automatic daily security updates, 1-click backup and restore, a web control panel, and preconfigured system monitoring with optional email alerts.

Features:

  • Base Operating System: Debian GNU/Linux 9 (Stretch).

  • Build formats: Deploys on bare metal, virtual machines (e.g., OpenStack, VMWare, VirtualBox, LXC, KVM, Xen) and in the cloud.

    • ISO images: Generic installable Live CD. Installs anywhere.
    • Virtual Machine images: Optimized for virtualized hardware, pre-installed and ready to run.
    • Amazon Machine Image (AMI): Best launched via the TurnKey Hub.
  • Free as in speech: free software with full source code and a powerful build system. Free of hidden backdoors, free from restrictive licensing and free to learn from, modify and distribute.

  • Secure and easy to maintain: Auto-updated daily with latest Debian security patches. Optional monitoring and email notification of system alerts.

  • 1-click backup and restore (TKLBAM): smart backup and data migration software saves changes to files, databases and package management to encrypted storage which a system can be automatically restored from.

  • Dynamic DNS (HubDNS): Associates your IP with a custom domain or the free *.tklapp.com domain.

  • Logical Volume Management (LVM): Instead of installing to a fixed size partition, a Logical Volume is first created by default, and this may later be expanded, even across multiple physical devices.

  • AJAX web shell (Web CLI) (shellinabox) - secure command line access from any web browser.

  • Web management interface (WebUI) (Webmin):

    • Listens on port 12321 (uses SSL).
    • Modern responsive theme: 'Authentic'.
    • Network modules:
      • Firewall configuration (with example configuration).
      • Network configuration.
    • System modules:
      • Backup and migration (TKLBAM).
      • Configure time, date and timezone.
      • Configure users and groups.
      • Manage software packages.
      • Change passwords.
      • System logs.
    • Tool modules:
      • Text editor.
      • Shell commands (note not proper interactive shell).
      • Simple file upload/download.
      • File manager (HTML5).
      • Custom commands.
    • Hardware modules:
      • Partitions on local disks.
      • Logical volume management.
  • Simple configuration console (cli) (confconsole):

    • Displays basic usage information.
    • Configure networking.
    • Let's Encrypt SSL/TLS certificates.
    • Mail SMTP relay setup.
    • Proxy settings.
    • Region and timezone.
    • Other global system settings.
  • First boot initialization (inithooks):

    • Prompt user for passwords.
    • Regenerates SSL and SSH cryptographic keys.
    • Installs latest security updates, unless user chooses to defer this for later.
  • Command line power tools

    • Smart, programmable bash shell completion: helps you get more done with fewer keystrokes.

    • Support for $HOME/.bashrc.d shell hooks

    • Persistent environment variables (see $HOME/.bashrc.d/penv):

      penv-set pydoc /usr/share/doc/python2.7/html
      exit
      # later...
      cd $pydoc
      
  • Automatic time synchronization with NTP

  • Take a look at some screenshots.

Credentials (passwords set at first boot)

  • Webmin, SSH, Shellinabox: username root