.\" generated with Ronn-NG/v0.9.1
.\" http://github.com/apjanke/ronn-ng/tree/0.9.1
.TH "UFFIZZI\-DEV\-START" "" "November 2023" ""
.SH "NAME"
\fBuffizzi\-dev\-start\fR \- start a development environment
.SH "SYNOPSIS"
.nf
uffizzi dev start [CONFIG_FILE] [FLAGS]
.fi
.SH "DESCRIPTION"
.nf
Creates a Uffizzi cluster preconfigured for development
workflows, including building, pushing, and deploying
your changes every time project files are saved\.
current\-context is updated in kubeconfig file\.

This command watches for file changes in a given local
project directory, as specified in your configuration file\.
It then serializes those changes and redeploys them onto
a Uffizzi cluster\.

The command looks for a configuration at the specified
path CONFIG_FILE\. Skaffold configurations are currently
supported\. For help creating a skaffold\.yaml file, see:
https://skaffold\.dev/docs/init/

For more information on Uffizzi clusters, see:
https://docs\.uffizzi\.com/references/cli/
.fi
.SH "POSITIONAL ARGUMENTS"
.nf
[CONFIG_FILE]
    Path to the development environment configuration file\.
    Currently supports skaffold\.yaml files\.
.fi
.SH "FLAGS"
.nf
 \-\-k8s\-version=<api\-version>
    Specify which version of the Kubernetes API to use when creating
    the cluster, formatted as [MAJOR]\.[MINOR]\. Defaults to 1\.27\.
    Minor versions point to the latest release of the corresponding k3s
    minor version\. See https://github\.com/k3s\-io/k3s/releases

 \-\-default\-repo="<container\-registry\-domain>"
    A public or private repo used to push/pull build
    artifacts\. Overrides the global default image registry:
    "registry\.uffizzi\.com"\. See `uffizzi connect \-h` for
    adding private registry credentials\.

 \-\-quiet, \-q
    Run the development process in detached mode (i\.e\., in
    the background)\. Without this option, logs are streamed
    to the terminal in the foreground\. Run \'uffizzi dev stop`
    to stop the detached process\.

 \-\-help, \-h
    Show this message and exit\.

 \-\-kubeconfig="/path/to/your/kubeconfig"
    Path to kubeconfig file\. If this option is not specified,
    this command looks for the file at ~/\.kube/config\.
.fi
.SH "EXAMPLES"
.nf
If your configuration file is in the current working
directory and you want to use an auto\-generated name,
run:

    $ uffizzi dev start

To start a dev environment using a skaffold\.yaml config
file in directory \'~/foo\', run:

    $ uffizzi dev start ~/foo/skaffold\.yaml

To start a dev environment in quiet  mode,
run:

    $ uffizzi dev start \-\-quiet

To start a dev environment using an alternate kubeconfig file,
run:

    $ uffizzi dev start \e
      \-\-kubeconfig="/path/to/alternate/kubeconfig"
.fi

