Chargie for Linux

Professional battery protection for Linux laptops. Extend your laptop battery lifespan by up to 4x.

amd64 & arm64 β€’ systemd service + desktop app
$ curl -fsSL https://chargie.org/install.sh | sh

One command. No manual dependency setup β€” the script installs everything it needs.

🐧

Supported Distributions

🟠

Ubuntu / Debian

Installs via apt-get

πŸ”΅

Fedora / RHEL / CentOS

Installs via dnf or yum

πŸ”·

Arch / Manjaro

Installs via pacman

🟒

openSUSE

Installs via zypper

Other distributions work too β€” if your package manager isn't recognized, the installer still sets up the binary, systemd service and desktop entry; you'll just install bluez, gtk3 and webkit2gtk manually (see Troubleshooting below).

0
Times Longer Battery Life
0
% Optimal Charge Level
0
Watts PD Support
0
Data Collected
πŸš€

Quick Install

curl -fsSL https://chargie.org/install.sh | sh

That's the whole install. No manual dependency setup is needed β€” the script detects your architecture and package manager, installs the required system packages (bluez, GTK 3, WebKit2GTK) itself, downloads the right binary, and sets up the systemd service and desktop entry, all in one run.

πŸ’‘
Don't have curl? The script also works with wget β€” if curl isn't found it falls back automatically:
wget -qO- https://chargie.org/install.sh | sh
If neither curl nor wget is installed, add one first (e.g. sudo apt-get install curl) β€” the installer needs one of them to download itself and the binary.

Under the hood, in order, the installer:

  1. Detects your OS, CPU architecture (amd64 or arm64) and package manager
  2. Installs system dependencies (bluez for Bluetooth, GTK 3 + WebKit2GTK for the app UI)
  3. Downloads the correct chargie-linux-<arch> binary to /opt/chargie-linux/chargie
  4. Symlinks it to /usr/local/bin/chargie so the chargie command works from anywhere
  5. Registers and enables a chargie.service systemd unit (skipped automatically on non-systemd systems)
  6. Creates a desktop entry so Chargie appears in your application launcher
  7. Adds your user to the bluetooth group if needed (you may need to log out and back in for this to take effect)

Already have Chargie installed? Re-running the same command upgrades it in place β€” the installer detects the existing install, stops the running service, and replaces the binary.

βš™οΈ

Install Options

Set these as environment variables before the command to customize the install:

  • CHARGIE_INSTALL_DIR β€” change the install location (default /opt/chargie-linux)
  • CHARGIE_NO_SERVICE=1 β€” skip setting up the systemd background service
  • CHARGIE_NO_DESKTOP=1 β€” skip creating the desktop launcher entry
  • CHARGIE_VERSION β€” install a specific version tag instead of latest
CHARGIE_NO_DESKTOP=1 curl -fsSL https://chargie.org/install.sh | sh
▢️

Running Chargie

1

Launch the desktop app

Open Chargie from your application launcher, or run chargie from any terminal.

2

Or start the background service

sudo systemctl start chargie, then open http://localhost:5858 in your browser to control it.

3

Enable Bluetooth

Chargie talks to the hardware device over Bluetooth Low Energy (BLE). Make sure Bluetooth is on before launching.

4

Set your charge limit

80% is recommended for laptops that stay plugged in often β€” it significantly extends battery lifespan.

πŸ’‘
Enable on boot: the systemd service is enabled automatically during install, so protection starts at every boot even if you never open the desktop app. Start it once manually the first time with sudo systemctl start chargie.

Useful commands

chargie # Launch the desktop app
sudo systemctl start chargie # Start the background service
systemctl status chargie # Check service status
journalctl -u chargie -f # View live service logs
πŸ”’

Privacy & Security

  • No data collection - Your data stays on device
  • Local Bluetooth only - No cloud, no internet required
  • No tracking - Zero analytics or telemetry
  • No account needed - Just install and use

The systemd service definition includes standard hardening (PrivateTmp, NoNewPrivileges) and only grants access to the Bluetooth adapter and USB devices it needs β€” nothing broader.

❓

Troubleshooting

"required command 'curl' not found" or download failsβ–Ό

The installer needs curl or wget to fetch itself and the binary. Install one first, then re-run:
Debian/Ubuntu: sudo apt-get install curl
Fedora/RHEL: sudo dnf install curl
Arch: sudo pacman -S curl
If curl is present but the download still fails, check your internet connection and that chargie.org is reachable.

"unsupported architecture" errorβ–Ό

Chargie Linux ships prebuilt binaries for x86_64/amd64 and aarch64/arm64 only. Run uname -m to check yours β€” other architectures (e.g. 32-bit ARM) aren't currently supported.

WebKit2GTK dependency warning during installβ–Ό

Some distro package repos ship WebKit2GTK under a different version name (4.0 vs 4.1). The installer tries both automatically and warns instead of failing if neither is found β€” the app itself will usually still run. If the desktop UI doesn't open, install your distro's WebKit2GTK package manually and try launching chargie again.

App can't find my Chargie deviceβ–Ό

1. Confirm Bluetooth is on: bluetoothctl show
2. Check Chargie is plugged into power (LED should be lit)
3. If you were just added to the bluetooth group, log out and back in β€” group membership doesn't apply to an already-open session
4. Try unplugging and re-plugging the Chargie device
5. Restart the service: sudo systemctl restart chargie

Systemd service doesn't start / not foundβ–Ό

The installer only sets up the systemd service on systems running systemd β€” if you're on a non-systemd init (or ran with CHARGIE_NO_SERVICE=1), no chargie.service unit exists and you'll need to launch the desktop app directly with chargie instead. Check status with systemctl status chargie and logs with journalctl -u chargie -f.

Desktop icon doesn't appear in the app launcherβ–Ό

Some desktop environments cache the application list. Log out and back in, or run update-desktop-database ~/.local/share/applications manually. If you installed with CHARGIE_NO_DESKTOP=1, no entry was created β€” launch with chargie from a terminal instead.

Permission errors during installβ–Ό

The installer uses sudo automatically for steps that need it (installing packages, writing to /opt and /etc/systemd/system) β€” you'll be prompted for your password. If you're already root, it skips sudo. Running the piped command inside a restricted container or without sudo access will cause these steps to fail.

πŸ—‘οΈ

Uninstalling

To fully remove Chargie β€” stop the service, delete the installed files, and remove the desktop entry:

sudo systemctl stop chargie 2>/dev/null
sudo systemctl disable chargie 2>/dev/null
sudo rm -rf /opt/chargie-linux
sudo rm -f /usr/local/bin/chargie
sudo rm -f /etc/systemd/system/chargie.service
rm -f ~/.local/share/applications/chargie.desktop
sudo systemctl daemon-reload 2>/dev/null

If you customized CHARGIE_INSTALL_DIR at install time, replace /opt/chargie-linux above with that path. This same block is printed at the end of every install, so you can always find it by re-running the installer.

πŸ“¬

Need Help?

🎫
Support

Submit a request
❓
FAQ

Common questions
πŸ”§
Guides

Troubleshooting
πŸ”
Chooser

Find your Chargie

We typically reply within 1 business day.

For order or refund issues, please include your order ID.

Get Help
πŸͺŸ
Windows User? Check out the Windows app guide β†’
🍎
Mac User? Check out the macOS app guide β†’
πŸ“±
iPhone or iPad? Check out the iOS app guide β†’
πŸ€–
Android User? Chargie works on Android too! Check out the Android app guide β†’

Last Updated: August 27, 2026

Shop