Skip to content

Commit 3802aad

Browse files
updates
1 parent d763509 commit 3802aad

File tree

1 file changed

+21
-20
lines changed

1 file changed

+21
-20
lines changed

content/install-guides/finch.md

Lines changed: 21 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Finch
2+
title: Finch on Arm Linux
33
author: Jason Andrews
44

55
minutes_to_complete: 10
@@ -22,19 +22,19 @@ multitool_install_part: false
2222
weight: 1
2323
---
2424

25-
[Finch](https://runfinch.com) is an open-source container development tool from AWS that provides a simple, Docker-compatible CLI for working with containers using containerd and nerdctl under the hood. Finch is designed for Linux, macOS, and Windows, and is especially useful on Arm-based systems for efficient container workflows.
25+
[Finch](https://runfinch.com) is an open-source container development tool from AWS. It offers a simple, Docker-compatible CLI powered by containerd and nerdctl. Designed for Linux, macOS, and Windows, Finch is especially useful on Arm-based systems for efficient container workflows.
2626

27-
This guide explains how to install and use Finch on Arm Linux distributions, specifically Amazon Linux 2023 and Ubuntu 24.04.
27+
This guide explains how to install Finch on Arm Linux distributions, specifically Amazon Linux 2023 and Ubuntu 24.04.
2828

29-
To use Finch as described in this install guide, you need a system running Arm Linux. You can use a physical Arm device, a cloud instance from AWS, Azure, GCP, or OCI, or an Arm-based virtual machine.
29+
To get started, make sure you're using a system running Arm Linux. You can use a physical Arm device, a cloud instance from AWS, Azure, GCP, or OCI, or an Arm-based virtual machine.
3030

3131
To confirm the architecture, run:
3232

3333
```bash
3434
uname -m
3535
```
3636

37-
The output is `aarch64` for 64-bit Arm systems.
37+
The output should be `aarch64` for 64-bit Arm systems.
3838

3939
## How do I install Finch on Amazon Linux 2023 for Arm?
4040

@@ -52,13 +52,13 @@ Enable and start the containerd service:
5252
sudo systemctl start containerd
5353
```
5454

55-
Confirm that the containerd service is running:
55+
Check that the containerd service is running:
5656

5757
```console
5858
sudo systemctl status containerd
5959
```
6060

61-
The output shows the status:
61+
You should see something like:
6262

6363
```output
6464
● containerd.service - containerd container runtime
@@ -74,17 +74,16 @@ The output shows the status:
7474
└─25841 /usr/bin/containerd
7575
```
7676

77-
The `finch` command is now available in your PATH. You can now skip to the section on verifying the Finch installation.
77+
The `finch` command is now available in your PATH. You can now skip to the section on [verifying the Finch installation](#how-do-i-verify-the-finch-installation).
7878

79-
## How do I install Finch on Ubuntu 24.04 for Arm?
8079

81-
Finch does not provide a Debian package for Ubuntu, but you can install it manually as described below.
80+
## How do I install Finch on Ubuntu 24.04 for Arm?
8281

83-
### What are the required Finch dependencies?
82+
Finch doesn't currently provide a Debian package for Ubuntu, but you can install it manually, using the three steps outlined below.
8483

85-
First, install Nerdctl by following the instructions in the [Nerdctl install guide](/install-guides/nerdctl/).
84+
### Step 1: Install Finch dependencies
8685

87-
You will also need various tools to build Finch. Install them using:
86+
Install Nerdctl by following the instructions in the [Nerdctl install guide](/install-guides/nerdctl/). Then install the required tools:
8887

8988
```console
9089
sudo apt install -y \
@@ -93,9 +92,9 @@ sudo apt install -y \
9392
build-essential
9493
```
9594

96-
### How do I build Finch from source code?
95+
### Step 2: Build and install Finch
9796

98-
Run the commands below to download and build Finch from source:
97+
Clone the Finch repository and build the binary:
9998

10099
```console
101100
git clone https://github.com/runfinch/finch.git
@@ -105,7 +104,7 @@ make
105104
sudo make install
106105
```
107106

108-
### How do I configure Finch?
107+
### Step 3: Configure Finch
109108

110109
Create the Finch configuration directories:
111110

@@ -155,19 +154,21 @@ The version is printed:
155154
finch version v1.8.2
156155
```
157156

158-
Run a simple container to confirm Finch is working:
157+
Run a container to confirm functionality:
159158

160159
```bash
161160
sudo finch run --rm armswdev/uname
162161
```
163162

164-
If you see the architecture printed, then Finch is working correctly. The expected output is:
163+
If you see the architecture printed, then Finch is working correctly.
164+
165+
The expected output is:
165166

166167
```output
167168
Architecture is aarch64
168169
```
169170

170-
Print the container images on your system:
171+
Print your local container images:
171172

172173
```bash
173174
sudo finch images
@@ -180,6 +181,6 @@ REPOSITORY TAG IMAGE ID CREATED PLATFORM SIZ
180181
armswdev/uname latest 82762f30a4a3 43 seconds ago linux/arm64 110.4MB 28.89MB
181182
```
182183

183-
Use `sudo finch help` to discover additional Finch commands.
184+
Use `sudo finch help` to explore available commands.
184185

185186
You are ready to use Finch to run containers on your Arm Linux system.

0 commit comments

Comments
 (0)