BasekickLabs

Native Installation

Install Arc Enterprise from the .deb, .rpm or Arch package, or build from source, then run it under systemd with a license key, storage backend, and cluster role in arc.toml.

Install Arc directly on Linux using native packages (.deb, .rpm) or build from source.

Latest Version

Current release: …

Prerequisites

  • Linux (x86_64 or ARM64)
  • 4GB RAM minimum, 8GB+ recommended
  • systemd (for service management)

Quick install

The following commands automatically fetch and install the latest Arc release.

x86_64 (AMD/Intel):

LATEST_VERSION=$(curl -s https://api.github.com/repos/basekick-labs/arc/releases/latest | grep tag_name | cut -d '"' -f 4 | sed 's/v//')
wget https://github.com/basekick-labs/arc/releases/download/v${LATEST_VERSION}/arc_${LATEST_VERSION}_amd64.deb
sudo dpkg -i arc_${LATEST_VERSION}_amd64.deb
sudo systemctl enable arc && sudo systemctl start arc
curl http://localhost:8000/health

ARM64:

LATEST_VERSION=$(curl -s https://api.github.com/repos/basekick-labs/arc/releases/latest | grep tag_name | cut -d '"' -f 4 | sed 's/v//')
wget https://github.com/basekick-labs/arc/releases/download/v${LATEST_VERSION}/arc_${LATEST_VERSION}_arm64.deb
sudo dpkg -i arc_${LATEST_VERSION}_arm64.deb
sudo systemctl enable arc && sudo systemctl start arc

Verify the RPM signature

From 26.09.4 the Arc RPMs (arc and arc-fips) are signed with the Basekick Labs package key. Recent rpm releases, such as rpm 6.1 on Fedora 45, refuse to install a package whose key has not been imported, so import the key once before installing:

sudo rpm --import https://github.com/basekick-labs/arc/releases/latest/download/RPM-GPG-KEY-basekick

The key is also in the repository at deploy/packaging/RPM-GPG-KEY-basekick. Its fingerprint is:

3E39 9CF8 F5D2 EF9A A9A5  36EF 7629 7AF0 8CBA B6FE

Check a downloaded package against it:

rpm -K arc-<version>-1.x86_64.rpm
# arc-<version>-1.x86_64.rpm: digests signatures OK

RPMs up to 26.09.3 are unsigned. dnf install ./arc-<version>-1.x86_64.rpm still installs them, with a warning; rpm -i refuses them where rpm enforces signatures.

Get your admin token

When Arc starts for the first time, it generates an admin token.

Save This Token

Copy this token immediately - you won't see it again!

sudo journalctl -u arc | grep -i "admin"

You should see:

======================================================================
  FIRST RUN - INITIAL ADMIN TOKEN GENERATED
======================================================================
  Admin API token: <admin-api-token>
======================================================================

The token is the value after Admin API token: (44 characters when Arc generates it). Save it:

export ARC_TOKEN="<admin-api-token>" ARC_ENDPOINT=http://localhost:8000

Export ARC_ENDPOINT with the token: arcli reads the two together from the environment, and fails with ARC_TOKEN needs ARC_ENDPOINT when only the token is set.

Storage backends

Local Filesystem - Default, data stored on disk.

Edit /etc/arc/arc.toml:

[storage]
backend = "local"
local_path = "/var/lib/arc/data"

Or via environment:

ARC_STORAGE_BACKEND=local
ARC_STORAGE_LOCAL_PATH=/var/lib/arc/data

The systemd unit sets the storage path

The packaged arc.service sets Environment="ARC_STORAGE_LOCAL_PATH=/var/lib/arc/data", and environment variables override arc.toml. A local_path edited in /etc/arc/arc.toml is ignored: the log still shows Storage backend initialized backend=local path=/var/lib/arc/data. See Move the data directory.

Service management

Start/stop/restart

sudo systemctl start arc      # Start
sudo systemctl stop arc       # Stop
sudo systemctl restart arc    # Restart
sudo systemctl status arc     # Status

View logs

sudo journalctl -u arc -f            # Follow logs
sudo journalctl -u arc -n 100        # Last 100 lines
sudo journalctl -u arc --since "1 hour ago"

Enable/disable auto-start

sudo systemctl enable arc     # Enable on boot
sudo systemctl disable arc    # Disable on boot

Configuration

Configuration file: /etc/arc/arc.toml

sudo nano /etc/arc/arc.toml
sudo systemctl restart arc

Common options

[server]
port = 8000

[storage]
backend = "local"
local_path = "/var/lib/arc/data"  # ignored under the packaged systemd unit, which sets ARC_STORAGE_LOCAL_PATH

[auth]
enabled = true

[compaction]
enabled = true
hourly_enabled = true
daily_enabled = true

[wal]
enabled = false  # Enable for zero data loss
sync_mode = "fdatasync"

[log]
level = "info"
format = "json"

See Configuration Overview for all options.

Data directory

Installation TypeDefault Data Directory
Package install/var/lib/arc/data
Source build./data/arc

Move the data directory

The package's systemd unit sets the local storage path with ARC_STORAGE_LOCAL_PATH, which takes precedence over local_path in /etc/arc/arc.toml. To store data somewhere else, stop Arc, copy the existing data, and override the variable in a drop-in:

sudo systemctl stop arc
sudo mkdir -p /srv/arc
sudo cp -a /var/lib/arc/data /srv/arc/data
sudo chown -R arc:arc /srv/arc
sudo systemctl edit arc

In the editor, add:

[Service]
Environment="ARC_STORAGE_LOCAL_PATH=/srv/arc/data"

Save, then start Arc and confirm the path:

sudo systemctl start arc
sudo journalctl -u arc | grep "Storage backend initialized"

Arc does not move data by itself. Skip the cp on a fresh install and create the empty directory instead.

Updating Arc

# Automatic update to latest version
LATEST_VERSION=$(curl -s https://api.github.com/repos/basekick-labs/arc/releases/latest | grep tag_name | cut -d '"' -f 4 | sed 's/v//')
wget https://github.com/basekick-labs/arc/releases/download/v${LATEST_VERSION}/arc_${LATEST_VERSION}_amd64.deb
sudo dpkg -i arc_${LATEST_VERSION}_amd64.deb
sudo systemctl restart arc

Up to 26.09.x, a .deb upgrade replaces /etc/arc/arc.toml with the packaged file, discarding your edits. Copy the file before upgrading and reapply your changes afterwards. From 27.01.1 the .deb keeps an existing /etc/arc/arc.toml.

Uninstalling

sudo systemctl stop arc
sudo dpkg -r arc

# Optional: Remove data
sudo rm -rf /var/lib/arc /etc/arc

Troubleshooting

Arc won't start

# Check logs
sudo journalctl -u arc -n 50

# Check port availability
sudo lsof -i :8000

Permission errors

sudo mkdir -p /var/lib/arc/data
sudo chown -R arc:arc /var/lib/arc

Memory issues

Override in /etc/arc/arc.toml:

[database]
memory_limit = "4GB"
max_connections = 16
thread_count = 8

Next steps

On this page