You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/install-guides/finch.md
+21-20Lines changed: 21 additions & 20 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,5 +1,5 @@
1
1
---
2
-
title: Finch
2
+
title: Finch on Arm Linux
3
3
author: Jason Andrews
4
4
5
5
minutes_to_complete: 10
@@ -22,19 +22,19 @@ multitool_install_part: false
22
22
weight: 1
23
23
---
24
24
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.
26
26
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.
28
28
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.
30
30
31
31
To confirm the architecture, run:
32
32
33
33
```bash
34
34
uname -m
35
35
```
36
36
37
-
The output is`aarch64` for 64-bit Arm systems.
37
+
The output should be`aarch64` for 64-bit Arm systems.
38
38
39
39
## How do I install Finch on Amazon Linux 2023 for Arm?
40
40
@@ -52,13 +52,13 @@ Enable and start the containerd service:
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).
78
78
79
-
## How do I install Finch on Ubuntu 24.04 for Arm?
80
79
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?
82
81
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.
84
83
85
-
First, install Nerdctl by following the instructions in the [Nerdctl install guide](/install-guides/nerdctl/).
84
+
### Step 1: Install Finch dependencies
86
85
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:
88
87
89
88
```console
90
89
sudo apt install -y \
@@ -93,9 +92,9 @@ sudo apt install -y \
93
92
build-essential
94
93
```
95
94
96
-
### How do I build Finch from source code?
95
+
### Step 2: Build and install Finch
97
96
98
-
Run the commands below to download and build Finch from source:
97
+
Clone the Finch repository and build the binary:
99
98
100
99
```console
101
100
git clone https://github.com/runfinch/finch.git
@@ -105,7 +104,7 @@ make
105
104
sudo make install
106
105
```
107
106
108
-
### How do I configure Finch?
107
+
### Step 3: Configure Finch
109
108
110
109
Create the Finch configuration directories:
111
110
@@ -155,19 +154,21 @@ The version is printed:
155
154
finch version v1.8.2
156
155
```
157
156
158
-
Run a simple container to confirm Finch is working:
157
+
Run a container to confirm functionality:
159
158
160
159
```bash
161
160
sudo finch run --rm armswdev/uname
162
161
```
163
162
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:
165
166
166
167
```output
167
168
Architecture is aarch64
168
169
```
169
170
170
-
Print the container images on your system:
171
+
Print your local container images:
171
172
172
173
```bash
173
174
sudo finch images
@@ -180,6 +181,6 @@ REPOSITORY TAG IMAGE ID CREATED PLATFORM SIZ
180
181
armswdev/uname latest 82762f30a4a3 43 seconds ago linux/arm64 110.4MB 28.89MB
181
182
```
182
183
183
-
Use `sudo finch help` to discover additional Finch commands.
184
+
Use `sudo finch help` to explore available commands.
184
185
185
186
You are ready to use Finch to run containers on your Arm Linux system.
0 commit comments