Install ArangoDB on Debian 11 in Minutes
If you’re running a fresh Debian 11 machine and want a multi‑model database that can handle documents, graphs, and key/value pairs, ArangoDB is the right choice. This guide gets you past the “how do I even start?” stage straight to the web UI where you’ll be creating collections like a pro.
1: Make sure your system is up‑to‑date
sudo apt update && sudo apt upgrade -y
Why bother? Debian’s security patches are a moving target; an outdated kernel or libstdc++ can bite you later when ArangoDB pulls in newer libraries. Updating first keeps the install smoother.
2: Import the ArangoDB GPG key
curl -fsSL https://download.arangodb.com/arangodb3/DEBIAN/GPG-KEY-ARANGODB | sudo gpg --dearmor -o /usr/share/keyrings/arango.gpg
The key tells apt that the packages come from a trustworthy source. Without it, you’ll get “NO_PUBKEY” errors and be forced to skip the repository.
3: Add the official Debian repository
echo "deb [signed-by=/usr/share/keyrings/arango.gpg] https://download.arangodb.com/arangodb3/DEBIAN/ stable main" | sudo tee /etc/apt/sources.list.d/arango.list > /dev/null
I’ve seen this happen after a bad driver update: the package list gets corrupted, and apt can’t resolve the repo URL. Adding it back fixes that.
4: Install ArangoDB
sudo apt update sudo apt install arangodb3-server arangodb3-client
The arangodb3-server package pulls in everything you need to run the daemon, while arangodb3-client gives you the command‑line tools. If you only care about the UI, this is still the minimal set.
5: Start and enable the service
sudo systemctl start arangod sudo systemctl enable arangod
Enabling makes sure ArangoDB starts automatically after a reboot—no more manual arangod launches. Starting it now verifies that dependencies like Java are in place.
6: Check the service status
sudo systemctl status arangod | grep Active
If you see “active (running)”, congratulations! If not, the log (/var/log/arangodb3/server.log) is your best friend. A common hiccup is missing libssl on older Debian releases; installing libssl1.1 fixes it.
7: Open the web UI
Navigate to < http://localhost:8529> in your browser. The first time you hit it, you’ll be prompted to set an administrator password—do that now and remember it.
8: Quick sanity check with a query
arangosh -c "db._create('test'); db.test.insert({foo:'bar'}); db.test.count();"
If the command returns 1, you’re good to go. If it complains about “database not found”, double‑check that the service is running.
9: Optional – Tighten security for production
- Disable HTTP on all interfaces: edit /etc/arangodb3/arangod.conf and set bind-address = 127.0.0.1.
- Enable TLS by generating a certificate and pointing tls.key-file / tls.cert-file.
I once ran into a client that kept crashing because the server was listening on all NICs, letting traffic flood in. Locking it down saved me a lot of headaches.
That’s everything you need to get ArangoDB up and running on Debian 11. Now go create some collections, write queries, or just marvel at how easy it was.