openshift-start-master - Man Page

Launch a master


openshift start master [Options]


Start a master server

This command helps you launch a master server.  Running

openshift start master

will start a master 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.

Note: starting the master 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 the master what public address it should use via --master= <ip>.

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



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


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


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,, and the asset server by default.


Indicates whether missing certs should be created


The address to listen for DNS requests on.

--etcd=" ⟨"⟩

The address of the etcd server (host, host:port, or URL). If specified, no built-in etcd will be started.


The etcd data directory.


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


The length of subnet each host is given from the network-cidr.


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.


Path to the kubeconfig file to use for requests to the Kubernetes API.

--kubernetes=" ⟨https://localhost:8443"⟩

removed in favor of --kubeconfig


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

--listen=" ⟨"⟩

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.


The CIDR string representing the network that all containers should belong to.


The name of the networking plugin to be used for networking.


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 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.


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


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

Options Inherited from Parent Commands


Path to the file containing Azure container registry configuration information.


Maximum number of seconds between log flushes


Print version information and quit

See Also

openshift-start(1), openshift-start-master-api(1), openshift-start-master-controllers(1),


June 2016, Ported from the Kubernetes man-doc generator

Referenced By

openshift-start(1), openshift-start-master-api(1), openshift-start-master-controllers(1).

Openshift CLI User Manuals June 2016