Installera NetBox

Vad NetBox är

Ett register över teknisk utrustning och nät. Vilka datorer ni har, vilka IP-adresser som är upptagna, vad som sitter i vilken kontakt, och vem som ansvarar för vad. Allt på ett ställe i stället för i tre kalkylark och ett huvud.

Det låter tråkigt tills första gången någon frågar vilken adress skrivaren har och ingen vet. Eller tills två personer råkar ge samma IP-adress till varsin maskin och halva nätet slutar fungera. NetBox finns för att den sortens frågor ska ha ett svar.

För de flesta företag är det här ett för stort verktyg. Det blir intressant om ni gör något åt IT-hållet, till exempel hjälper en förening eller ett företag med deras utrustning, för då är registret en del av tjänsten ni säljer.

Det här är ett serverprogram

NetBox installeras inte som ett vanligt program. Det är en webbtjänst som körs i containrar och som ni når via webbläsaren. Verktyget som kör dem är Docker, samma som i Installera Docker. Har ni inte Docker på plats, börja där och kom tillbaka hit.

På Windows innebär Docker Desktop att ni också får WSL2, alltså Windows inbyggda Linux. Docker Desktop installerar det normalt själv, men blir ni tillfrågade ska ni svara ja. Utan WSL2 startar ingen container.

Ni behöver också git, alltså programmet som hämtar kod från nätet. Det följer inte med Windows, och det är där många fastnar på rad ett.

Windows

Installera git först. Öppna PowerShell och kör:

winget install Git.Git

Stäng fönstret och öppna ett nytt, annars känner PowerShell inte igen kommandot ännu. Kör sedan de fyra raderna:

git clone -b release https://github.com/netbox-community/netbox-docker.git
cd netbox-docker
copy docker-compose.override.yml.example docker-compose.override.yml
docker compose up -d

Linux Mint

Samma sak, med två små skillnader. Git installeras med paketverktyget, och kopieringskommandot heter något annat. Öppna Terminal:

sudo apt-get install git
git clone -b release https://github.com/netbox-community/netbox-docker.git
cd netbox-docker
cp docker-compose.override.yml.example docker-compose.override.yml
docker compose up -d

Första starten tar flera minuter, för NetBox sätter upp sin databas innan den öppnar. Följ med i docker compose logs -f om ni vill se vad som händer, och tryck Ctrl och C för att komma ur loggen utan att stänga av något. Surfa sedan till http://localhost:8000.

Tre saker att göra först

1. Skapa ett administratörskonto, för ni kommer inte in utan ett: docker compose exec netbox /opt/netbox/netbox/manage.py createsuperuser. Den frågar efter användarnamn och lösenord i fönstret. Det här steget saknas i förvånansvärt många guider, och då ser det ut som att inloggningen är trasig.
2. Lägg in er egen utrustning, inte exempelutrustning. Börja med en plats och en enhet. Strukturen i NetBox är sträng, och den blir begriplig först när ni försöker pressa in något ni faktiskt har.
3. Registrera ert riktiga nät under IPAM, till exempel 192.168.1.0/24, och lägg in adresserna ni vet är upptagna. Det tar tjugo minuter och besvarar frågan som verktyget finns till för.

Den vanligaste fällan

Att tro att containern är säkerhetskopian. Allt ni matar in hamnar i volymer som ligger kvar vid omstart och uppgradering. Men kör någon docker compose down med flaggan -v på slutet raderas volymerna, och hela registret följer med. Just den flaggan finns i var tredje guide på nätet, eftersom den är bekväm när man testar. På er riktiga installation ska den aldrig användas.

Exportera därför tabellerna till CSV med jämna mellanrum, vilket går från listvyerna, och lägg filerna där företaget sparar annat som inte får försvinna. En CSV-fil går att öppna i vilket kalkylprogram som helst, även om NetBox inte finns kvar.

En sak till om minnet: NetBox startar flera containrar samtidigt, bland annat en databas och en kö. På en dator med 8 GB minne går det, men lämna inte tio andra program öppna samtidigt och undra varför allt kryper.