This guide uses Docker to run RANCID for network configuration monitoring.
For Docker installation, see Docker.
RANCID has no official Docker image. This guide uses a community-maintained image.
Create a directory to store your configuration and compose files.
mkdir -p /opt/rancid
cd /opt/rancid
mkdir -p etc var/log
services:
rancid:
image: slankes/rancid:latest
container_name: rancid
ports:
- "8080:80"
volumes:
- ./etc:/etc/rancid
- ./var:/var/rancid
environment:
- RANCID_GROUP=mycompany
- RANCID_USER=rancid
- RANCID_PASSWORD=rancid_password
- MAILDOMAIN=example.com
restart: unless-stopped
For more control, create a Dockerfile:
FROM ubuntu:22.04
RUN apt-get update && apt-get install -y \
rancid \
git \
expect \
&& rm -rf /var/lib/apt/lists/*
EXPOSE 80
CMD ["/usr/sbin/rancid-run"]
Create etc/mycompany/router.db:
router1.example.com:cisco
switch1.example.com:cisco
firewall1.example.com:pix
Edit etc/mycompany/rancid.conf:
LIST_OF_GROUPS="mycompany"
Start the container in the background.
docker compose up -d
Any questions?
Feel free to contact us. Find all contact information on our contact page.