Skip to content

Installing Finch

To install Finch, please see the dedicated section for each operating system family:

Verify the Finch Installation

Once Finch has been successfully installed, you can verify the installation with the following steps.

  1. On macOS and Windows (skip on Linux), ensure the Finch virtual machine is initialized and running with the finch vm init. This initial setup usually takes about a minute, and may once again require the users password.

    $ finch vm init

  2. Verify that everything is working correctly by attempting to run the Finch demonstration container image hello-finch.

    $ finch run public.ecr.aws/finch/hello-finch:latest

    $ finch run public.ecr.aws/finch/hello-finch:latest

    $ sudo finch run public.ecr.aws/finch/hello-finch:latest

    If everything is ok, you should now see the output:

                                @@@@@@@@@@@@@@@@@@@
                        @@@@@@@@@@@@    @@@@@@@@@@@
                      @@@@@@@                  @@@@@@@
                    @@@@@@                        @@@@@@
                  @@@@@@                            @@@@@
                 @@@@@                      @@@#     @@@@@@@@@
                @@@@@                     @@   @@@       @@@@@@@@@@
                @@@@%                     @     @@            @@@@@@@@@@@
                @@@@                                               @@@@@@@@
                @@@@                                         @@@@@@@@@@@&
                @@@@@                                  &@@@@@@@@@@@
                 @@@@@                               @@@@@@@@
                  @@@@@                            @@@@@(
                   @@@@@@                        @@@@@@
                     @@@@@@@                  @@@@@@@
                        @@@@@@@@@@@@@@@@@@@@@@@@@@
                            @@@@@@@@@@@@@@@@@@


Hello from Finch!

Visit us @ github.com/runfinch

Next Steps

In this short guide you learned how to install Finch on to your workstation and start the virtual machine.