OPENSHIFT(1)

NAME

openshift start - Launch all-in-one server

SYNOPSIS

openshift start [OPTIONS]

DESCRIPTION

Start an all-in-one server

This command helps you launch an all-in-one server, which allows you to run all of the components of an enterprise Kubernetes system on a server with Docker. Running:

openshift start

will start listening on all interfaces, launch an etcd server to store persistent data, and launch the Kubernetes system components. The server will run in the foreground until you terminate the process. This command delegates to "openshift start master" and "openshift start node".

Note: starting OpenShift without passing the --master address will attempt to find the IP address that will be visible inside running Docker containers. This is not always successful, so if you have problems tell OpenShift what public address it will be via --master= <ip>.

You may also pass --etcd= <address>to connect to an external etcd server.

You may also pass --kubeconfig= <path>to connect to an external Kubernetes cluster.

OPTIONS

--certificate-authority=[]
    Optional files containing signing authorities to use (in addition to the generated signer) to verify the API server's serving certificate.

--cors-allowed-origins=[]
    List of allowed origins for CORS, comma separated. An allowed origin can be a regular expression to support subdomain matching. CORS is enabled for localhost, 127.0.0.1, and the asset server by default.

--create-certs=true
    Indicates whether missing certs should be created.

--dns="tcp://0.0.0.0:8053"
    The address to listen for DNS requests on.

--etcd=" ⟨https://0.0.0.0:4001"⟩
    The address of the etcd server (host, host:port, or URL). If specified, no built-in etcd will be started.

--etcd-dir="openshift.local.etcd"
    The etcd data directory.

--expire-days=730
    Validity of the certificates in days (defaults to 2 years). WARNING: extending this above default value is highly discouraged.

--hostname="<hostname>"
    The hostname to identify this node with the master.

--images="openshift3/ose-${component}:${version}"
    When fetching images used by the cluster for important components, use this format on both master and nodes. The latest release will be used by default.

--latest-images=false
    If true, attempt to use the latest images for the cluster instead of the latest release.

--listen=" ⟨https://0.0.0.0:8443"⟩
    The address to listen for connections on (scheme://host:port).

--master=" ⟨https://localhost:8443"⟩
    The master address for use by OpenShift components (host, host:port, or URL). Scheme and port default to the --listen scheme and port. When unset, attempt to use the first public IPv4 non-loopback address registered on this host.

--master-config=""
    Location of the master configuration file to run from. When running from configuration files, all other command-line arguments are ignored.

--network-plugin=""
    The network plugin to be called for configuring networking for pods.

--node-config=""
    Location of the node configuration file to run from. When running from configuration files, all other command-line arguments are ignored.

--pause=false
    If true, wait for a signal before starting the controllers.

--portal-net="172.30.0.0/16"
    The CIDR string representing the network that portal/service IPs will be assigned from. This must not overlap with any IP ranges assigned to nodes for pods.

--print-ip=false
    Print the IP that would be used if no master IP is specified and exit.

--public-master=" ⟨https://localhost:8443"⟩
    The master address for use by public clients, if different (host, host:port, or URL). Defaults to same as --master.

--signer-expire-days=1825
    Validity of the CA certificate in days (defaults to 5 years). WARNING: extending this above default value is highly discouraged.

--volume-dir="openshift.local.volumes"
    The volume storage directory.

--write-config=""
    Directory to write an initial config into. After writing, exit without starting the server.

OPTIONS INHERITED FROM PARENT COMMANDS

--azure-container-registry-config=""
    Path to the file container Azure container registry configuration information.

--google-json-key=""
    The Google Cloud Platform Service Account JSON Key to use for authentication.

--log-flush-frequency=0
    Maximum number of seconds between log flushes

SEE ALSO

openshift(1), openshift-start-etcd(1), openshift-start-kubernetes(1), openshift-start-master(1), openshift-start-network(1), openshift-start-node(1),

HISTORY

June 2016, Ported from the Kubernetes man-doc generator