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