Installation

Quick Install (auto-detects your platform)

curl -fsSL https://getarcan.dev/install.sh | sh

The install script detects your OS and architecture, downloads the correct binary, verifies the SHA-256 checksum, and installs to /usr/local/bin (or ~/.local/bin if not root).

---

macOS

Homebrew (recommended)

brew install GetArcan/tap/arcan

Works on both Apple Silicon (M1/M2/M3/M4) and Intel Macs.

Manual Download

Architecture	Download
Apple Silicon (M1+)	arcan_0.1.0_darwin_arm64.tar.gz
Intel	arcan_0.1.0_darwin_amd64.tar.gz

# Apple Silicon
curl -LO https://github.com/GetArcan/arcan/releases/latest/download/arcan_0.1.0_darwin_arm64.tar.gz
tar xzf arcan_0.1.0_darwin_arm64.tar.gz
sudo mv arcan /usr/local/bin/

# Intel
curl -LO https://github.com/GetArcan/arcan/releases/latest/download/arcan_0.1.0_darwin_amd64.tar.gz
tar xzf arcan_0.1.0_darwin_amd64.tar.gz
sudo mv arcan /usr/local/bin/

macOS Gatekeeper

If macOS blocks the binary, run: xattr -d com.apple.quarantine /usr/local/bin/arcan

---

Linux

One-Line Install

curl -fsSL https://getarcan.dev/install.sh | sh

Manual Download

Architecture	Download
x86_64 (amd64)	arcan_0.1.0_linux_amd64.tar.gz
ARM64 (aarch64)	arcan_0.1.0_linux_arm64.tar.gz

# x86_64
curl -LO https://github.com/GetArcan/arcan/releases/latest/download/arcan_0.1.0_linux_amd64.tar.gz
tar xzf arcan_0.1.0_linux_amd64.tar.gz
sudo mv arcan /usr/local/bin/

# ARM64
curl -LO https://github.com/GetArcan/arcan/releases/latest/download/arcan_0.1.0_linux_arm64.tar.gz
tar xzf arcan_0.1.0_linux_arm64.tar.gz
sudo mv arcan /usr/local/bin/

Debian / Ubuntu (.deb)

Coming in v0.1.x. For now, use the curl installer or manual download above.

# Coming soon:
# sudo apt install arcan

RHEL / Fedora / Amazon Linux (.rpm)

Coming in v0.1.x. For now, use the curl installer or manual download above.

# Coming soon:
# sudo yum install arcan

Alpine Linux

Coming in v0.1.x. Use Docker for Alpine environments today.

Run as a systemd Service

After installing the binary, generate and install a systemd unit:

arcan generate systemd | sudo tee /etc/systemd/system/arcan.service
sudo systemctl daemon-reload
sudo systemctl enable --now arcan

---

Docker

docker run -d \
  --name arcan \
  -p 8443:8443 \
  -v arcan-data:/home/arcan/.arcan \
  getarcan/arcan:latest

The data volume persists the master key, database, TLS certificates, and plugins across container restarts.

Docker Compose

arcan generate docker > docker-compose.yaml
docker compose up -d

Available Tags

Tag	Description
latest	Latest stable release
0.1.0	Specific version

Images are published to both Docker Hub (getarcan/arcan) and GitHub Container Registry (ghcr.io/getarcan/arcan).

---

Kubernetes

Helm Chart

helm install arcan ./deploy/helm/arcan \
  --set masterKey.existingSecret=arcan-master-key

Generate Manifests

arcan generate k8s > arcan-k8s.yaml
kubectl apply -f arcan-k8s.yaml

See Kubernetes ESO for External Secrets Operator integration and Sidecar for the sidecar injection pattern.

---

From Source

Requires Go 1.22+ and a C compiler (for SQLite):

git clone https://github.com/GetArcan/arcan.git
cd arcan
CGO_ENABLED=1 go build -o arcan ./cmd/arcan
sudo mv arcan /usr/local/bin/

Or with go install:

CGO_ENABLED=1 go install getarcan.dev/arcan/cmd/arcan@latest

---

Platform Support

Platform	Architecture	v0.1.0	Method
macOS	Apple Silicon (arm64)	✅	Homebrew, curl, binary
macOS	Intel (amd64)	✅	Homebrew, curl, binary
Linux	x86_64 (amd64)	✅	curl, binary, Docker
Linux	ARM64 (aarch64)	✅	curl, binary, Docker
Linux	Debian/Ubuntu (.deb)	Coming v0.1.x	—
Linux	RHEL/Fedora (.rpm)	Coming v0.1.x	—
Linux	Alpine (.apk)	Coming v0.1.x	Docker available now
Windows	amd64	Coming v0.2.0	—
FreeBSD	amd64	Coming v0.2.0	—

---

Verify Installation

arcan --version
# arcan 0.1.0 (commit: abc1234, built: 2026-04-06T12:00:00Z)

System Requirements

Requirement	Minimum
Memory	64 MB
Disk	50 MB (binary + data)
Network	Port 8443 (HTTPS)
Go (from source only)	1.22+ with CGO

Next Steps

Once installed, follow the Quick Start to store your first secret in 5 minutes.