README

rkt - the pod-native container engine

godoc Build Status (Travis) Build Status (SemaphoreCI) Go Report Card

rkt Logo

rkt (pronounced like a "rocket") is a CLI for running application containers on Linux. rkt is designed to be secure, composable, and standards-based.

Some of rkt's key features and goals include:

Project status

The rkt v1.x series provides command line user interface and on-disk data structures stability for external development. Any major changes to those primary areas will be clearly communicated, and a formal deprecation process conducted for any retired features.

Check out the roadmap for more details on the future of rkt.

Trying out rkt

To get started quickly using rkt for the first time, start with the "trying out rkt" document. Also check rkt support on your Linux distribution. For an end-to-end example of building an application from scratch and running it with rkt, check out the getting started guide.

Getting help with rkt

There are a number of different avenues for seeking help and communicating with the rkt community:

  • For bugs and feature requests (including documentation!), file an issue
  • For general discussion about both using and developing rkt, join the rkt-dev mailing list
  • For real-time discussion, join us on IRC: #rkt-dev on freenode.org
  • For more details on rkt development plans, check out the GitHub milestones

Most discussion about rkt development happens on GitHub via issues and pull requests. The rkt developers also host a semi-regular community sync meeting open to the public. This sync usually features demos, updates on the roadmap, and time for anyone from the community to ask questions of the developers or share users stories with others. For more details, including how to join and recordings of previous syncs, see the sync doc on Google Docs.

Contributing to rkt

rkt is an open source project and contributions are gladly welcomed! See the Hacking Guide for more information on how to build and work on rkt. See CONTRIBUTING for details on submitting patches and the contribution workflow.

Licensing

Unless otherwise noted, all code in the rkt repository is licensed under the Apache 2.0 license. Some portions of the codebase are derived from other projects under different licenses; the appropriate information can be found in the header of those source files, as applicable.

Security disclosure

If you suspect you have found a security vulnerability in rkt, please do not file a GitHub issue, but instead email security@coreos.com with the full details, including steps to reproduce the issue. CoreOS is currently the primary sponsor of rkt development, and all reports are thoroughly investigated by CoreOS engineers. For more information, see the CoreOS security disclosure page.

Known issues

Check the troubleshooting document.

Integrations and Production Users
Expand ▾ Collapse ▴

Directories

Path Synopsis
Documentation
api
v1
v1alpha
Package v1alpha is a generated protocol buffer package.
Package v1alpha is a generated protocol buffer package.
Package common defines values shared by different parts of rkt (e.g.
Package common defines values shared by different parts of rkt (e.g.
networking
networking is the package that implements small functionality shared between state0 and stage1.
networking is the package that implements small functionality shared between state0 and stage1.
Package rkt is expected to be used by other projects who want to integrate with rkt.
Package rkt is expected to be used by other projects who want to integrate with rkt.
kvm.go file provides networking supporting functions for kvm flavor
kvm.go file provides networking supporting functions for kvm flavor
pkg
aci
Package aci implements helper functions for working with ACIs
Package aci implements helper functions for working with ACIs
aci/acitest
Package acitest provides utilities for ACI testing.
Package acitest provides utilities for ACI testing.
acl
Package acl is a wrapper over libacl that dlopens it instead of being linked to it.
Package acl is a wrapper over libacl that dlopens it instead of being linked to it.
fs
keystore
Package keystore implements the ACI keystore.
Package keystore implements the ACI keystore.
keystore/keystoretest
Package keystoretest provides utilities for ACI keystore testing.
Package keystoretest provides utilities for ACI keystore testing.
lock
Package lock implements simple locking primitives on a regular file or directory using flock
Package lock implements simple locking primitives on a regular file or directory using flock
log
pod
package pod contains the data structure for the pod and functions to get information of the pod.
package pod contains the data structure for the pod and functions to get information of the pod.
set
sys
tar
Package tar contains helper functions for working with tar files
Package tar contains helper functions for working with tar files
tpm
user
Package user allows resolving user UIDs/GIDs using various methods.
Package user allows resolving user UIDs/GIDs using various methods.
rkt
Package rkt (main) implements the command line interface to rkt
Package rkt (main) implements the command line interface to rkt
image
Package image implements finding images in the store and fetching them from local or remote locations.
Package image implements finding images in the store and fetching them from local or remote locations.
stage1
gc
init/kvm
kvm package provides supporting functions for kvm flavor such as: VM networking, volume sharing
kvm package provides supporting functions for kvm flavor such as: VM networking, volume sharing
gc
run
store
db
imagestore
Package store implements a content-addressable-store on disk.
Package store implements a content-addressable-store on disk.
tools