Det här sätter du upp
NocoDB gör en databas till något som fungerar som ett kalkylark. Teamet håller kunder, projekt, ordrar eller lager i tabeller, länkar poster mellan dem och ser samma data som ett rutnät, en kanbantavla, ett galleri eller en kalender. En formulärvy tar emot poster från personer utan konto, en delad länk visar en vy som bara går att läsa, och allt går att läsa och skriva via ett REST-API och webhooks.
NocoDB görs av NocoDB, Inc., som också säljer NocoDB Cloud och betalda licenser för att köra det själv. Sedan version 0.301.0, som släpptes i januari 2026, är NocoDB inte längre öppen källkod: det bytte från AGPL till Sustainable Use License, samma "fair-code"-licens som n8n använder. Den låter dig använda och ändra NocoDB gratis för ditt eget företags interna arbete, och för privat eller ideellt bruk. Den låter dig inte sälja det, eller driva det som en tjänst åt andra mot betalning, till exempel som en databas du driftar åt dina kunder. Du får bara lämna det vidare gratis och i icke-kommersiellt syfte. Versioner till och med 0.265 ligger kvar under AGPL.
Det du får gratis är Community Edition. Gränssnittet visar resten med märket Business, Enterprise, Add-on eller Scale, och i våra tester krävde de en betald licens: tvåfaktorsautentisering, inloggning via OIDC eller SAML, team, SCIM, administratörens granskningslogg, behörigheter per tabell och fält, behörigheter per rad, tidslinje- och Gantt-vyer, unika fält, färger på rader och celler, egna länkar och logotyper för delade formulär, dashboards, synk med andra tjänster och AI-funktionerna. Gratisversionen har en arbetsyta. Under Account settings > Profile döljer Show only community edition features märkena.
Här körs NocoDB som en pod under en egen användare som heter nocodb, från NocoDB:s officiella avbild, med PostgreSQL för dess data, bakom Caddy från Podman-guiden.
Varje steg nedan har körts på en nyinstallerad Melonslab VC-P Alloy (2 vCPU, 8 GB) med Debian 13:
- NocoDB 2026.09.0 startade med PostgreSQL 17. Superadministratören skapades via en SSH-tunnel, och registreringen stängdes, innan Caddy sattes upp. Utifrån fick en registrering svaret "Not allowed to signup, contact super admin."
- Tre användare bjöds in, två med en länk via e-post och en med en kopierad länk. De som fick en roll såg basen; den utan roll såg ingenting.
- En bas med två tabeller skapades, med fält för text, e-post, telefon, enkelval, datum, valuta, kryssruta och bilagor, och en länk från projekt till kunder. En kanbanvy grupperade projekten efter status.
- En delad rutnätsvy öppnades utan inloggning och gick inte att ändra. Ett publikt formulär lade till en post. En fil som laddades upp till en post gick bara att hämta via en länk som slutar gälla.
- En API-token listade och skapade poster via REST-API:t, och en webhook skickade varje ny post till en annan tjänst, även till en annan app på samma server med inställningen från Podman-guiden.
- Gränssnittet visades på svenska.
- En avlyssning av serverns trafik visade en enda extern anslutning, till GitHub, för att leta efter uppdateringar. Ett skript som webbläsaren laddar från supportchatten Chatwoot blockerades av Caddy.
- En inbjudan och en återställning av lösenord skickades via en SMTP-testserver på samma maskin. Utan e-post skickade återställningen tyst ingenting, som steg 6 beskriver.
- NocoDB återställdes från en säkerhetskopia till tomma volymer, uppdaterades till 2026.09.1, och allt, inloggningar också, startade igen av sig självt efter en omstart av servern.
Podden använde omkring 850 MB minne, varav omkring 800 MB för NocoDB.
Innan du börjar
Du behöver:
- en server uppsatt som i Podman-guiden, med Caddy igång;
- en A-post och en AAAA-post för
nocodb.example.comsom pekar på din server.
Exemplen använder nocodb.example.com för NocoDB och 203.0.113.10 för serverns IPv4-adress. Byt ut dem genomgående.
1. Skapa användaren
Som root:
useradd -m -s /bin/bash nocodb
loginctl enable-linger nocodb
machinectl shell nocodb@
Allt fram till steg 5 körs som nocodb.
2. Skapa hemligheterna
password=$(openssl rand -hex 24)
printf %s "$password" | podman secret create nocodb-db-password -
printf %s "pg://127.0.0.1:5432?u=nocodb&p=$password&d=nocodb" | podman secret create nocodb-db-url -
unset password
openssl rand -hex 32 | tr -d '\n' | podman secret create nocodb-jwt-secret -
De tre första raderna skapar ett databaslösenord och lagrar det två gånger: för sig självt åt PostgreSQL, och inuti anslutningsadressen, NC_DB, som NocoDB använder. Den sista raden skapar nyckeln som NocoDB signerar sina inloggningar med. Utan en egen nyckel skapar NocoDB en ny varje gång den startar, och alla loggas ut. Podman lagrar alla tre, inte filerna nedan.
3. Definiera podden
mkdir -p ~/.config/containers/systemd
cd ~/.config/containers/systemd
Skapa nocodb.pod:
[Pod]
PodName=nocodb
# Only Caddy, on this server, can reach NocoDB: the port is not open to the internet.
PublishPort=127.0.0.1:8116:8080
[Install]
WantedBy=default.target
Skapa nocodb-db.container:
[Container]
ContainerName=nocodb-db
Image=docker.io/library/postgres:17
Pod=nocodb.pod
Volume=nocodb-db:/var/lib/postgresql/data
Environment=POSTGRES_USER=nocodb POSTGRES_DB=nocodb
Secret=nocodb-db-password,type=env,target=POSTGRES_PASSWORD
HealthCmd=pg_isready -U nocodb -d nocodb
HealthInterval=10s
Notify=healthy
AutoUpdate=registry
[Service]
Restart=always
Och nocodb-app.container:
[Unit]
Requires=nocodb-db.service
After=nocodb-db.service
[Container]
ContainerName=nocodb-app
Image=docker.io/nocodb/nocodb:2026.09.1
Pod=nocodb.pod
Volume=nocodb-data:/usr/app/data
Environment=NC_SITE_URL=https://nocodb.example.com
Environment=NC_DISABLE_TELE=true NC_DISABLE_ERR_REPORTS=true NC_DISABLE_SUPPORT_CHAT=true
Environment=NC_SECURE_ATTACHMENTS=true
Secret=nocodb-db-url,type=env,target=NC_DB
Secret=nocodb-jwt-secret,type=env,target=NC_AUTH_JWT_SECRET
[Service]
Restart=always
Det här gör inställningarna:
NC_DBpekar NocoDB mot PostgreSQL i samma pod. NocoDB lägger både sina egna inställningar och dina tabeller där; utan den använder den en SQLite-fil.NC_SITE_URLär den publika adressen som NocoDB lägger i länkar för inbjudningar och återställning av lösenord.NC_DISABLE_TELE,NC_DISABLE_ERR_REPORTSochNC_DISABLE_SUPPORT_CHATstänger av användningsstatistik, felrapporter och supportchatten. Steg 15 tar upp vad som är kvar.NC_SECURE_ATTACHMENTS=truegör att uppladdade filer bara går att hämta via länkar som slutar gälla efter ungefär två timmar, i stället för via en fast adress som fungerar utan inloggning. NocoDB:s dokumentation kallar inställningenNC_ATTACHMENT_ACCESS_CONTROL_ENABLEDnumera, men i 2026.09 fungerade bara det äldre namnet.- De uppladdade filerna hamnar i volymen
nocodb-data, resten i databasen.
NocoDB ligger kvar på en exakt version, eftersom den ändrar sin databas när den uppdateras, och en uppdatering bör börja med en säkerhetskopia (se Uppdatera). PostgreSQL följer version 17 av sig själv via podman-auto-update.timer. Starta den:
systemctl --user daemon-reload
systemctl --user start nocodb-pod
systemctl --user enable --now podman-auto-update.timer
Första starten laddar ner omkring 1,4 GB avbilder, och NocoDB tar en minut på sig att sätta upp sin databas. Den är klar när det här skriver ut {"message":"OK" och lite till:
curl -s http://127.0.0.1:8116/api/v1/health
4. Skapa superadministratören via en SSH-tunnel
Tills någon har registrerat sig blir den som först öppnar NocoDB dess superadministratör, och därefter kan vem som helst registrera sig. Caddy visar inte NocoDB för någon än, så gör båda delarna genom en SSH-tunnel, som bara du har. Vår testserver fick sitt första besök från en skanner tre sekunder efter att certifikatet utfärdades.
Öppna en tunnel från din egen dator till NocoDB:s port på servern, och låt den vara öppen:
ssh -L 8116:127.0.0.1:8116 root@203.0.113.10
Öppna http://localhost:8116 i webbläsaren. Den visar SIGN UP. Ange din E-mail och ett långt Password, lämna Subscribe to our weekly newsletter avstängt och välj SIGN UP. NocoDB frågar vad du tänker använda det till; Skip längst ner hoppar över det.
Stäng nu registreringen. Öppna kontomenyn längst ner till vänster, välj Admin Panel, sedan Settings, och kryssa i Allow signup only using invite url. Det sparas direkt.
Gratisversionen har ingen tvåfaktorsautentisering, så ge varje konto ett starkt lösenord. Stäng tunneln när du är klar.
NocoDB:s dokumentation nämner också NC_INVITE_ONLY_SIGNUP=true för det här. I våra tester med 2026.09 gjorde den ingen skillnad: en främling kunde registrera sig tills rutan var ikryssad.
5. Sätt Caddy framför
Gå tillbaka till root med exit, byt till machinectl shell caddy@ och lägg till det här blocket sist i ~/Caddyfile:
nocodb.example.com {
header Content-Security-Policy "script-src 'self' 'unsafe-inline' 'unsafe-eval' blob:; frame-src 'self' blob:"
reverse_proxy 127.0.0.1:8116
}
Starta om Caddy med systemctl --user restart caddy och öppna https://nocodb.example.com. Logga in med kontot från steg 4.
Raden header hindrar webbläsare från att ladda skript och ramar från andra webbplatser. NocoDB:s sidor laddar supportchatten Chatwoot från app.chatwoot.com i varje besökares webbläsare, även med NC_DISABLE_SUPPORT_CHAT=true; med den här raden vägrar webbläsaren. Allt annat i guiden fungerade med den.
För att kontrollera att registreringen är stängd öppnar du https://nocodb.example.com/signup i ett privat fönster och försöker. Svaret blir "Not allowed to signup, contact super admin."
6. E-post
NocoDB skickar e-post för inbjudningar och återställning av lösenord. Guidens tester använde en SMTP-testserver på samma maskin; vi har inte skickat till riktiga brevlådor. Utan e-post:
- visar Invite User i Admin Panel inbjudningslänken med "Looks like you have not configured mailer yet!", och du skickar länken själv;
- säger Forgot your password ? på inloggningssidan "Please check your email to reset the password", men skickar ingenting och loggar ingenting.
För att skicka e-post pekar du NocoDB mot din e-postleverantörs SMTP-server. Som nocodb lagrar du lösenordet som en hemlighet:
printf %s 'the-smtp-password' | podman secret create nocodb-smtp-password -
Lägg sedan till de här raderna i nocodb-app.container, under de andra Secret=-raderna, med din egen server, ditt konto och din avsändaradress:
Environment=NC_SMTP_HOST=mail.example.com NC_SMTP_PORT=587 NC_SMTP_SECURE=false
Environment=NC_SMTP_USERNAME=nocodb@example.com NC_SMTP_FROM=nocodb@example.com
Secret=nocodb-smtp-password,type=env,target=NC_SMTP_PASSWORD
Starta om NocoDB:
systemctl --user daemon-reload
systemctl --user restart nocodb-app
På port 587 börjar NC_SMTP_SECURE=false utan TLS och byter till TLS med STARTTLS när servern erbjuder det, som leverantörer gör. För port 465, som använder TLS från början, anger du NC_SMTP_PORT=465 NC_SMTP_SECURE=true. Admin Panel > Setup visar sedan Configure E-mail med en grön bock, och Forgot your password ? skickar e-postmeddelandet "Reset your password".
7. Bjud in teamet
Välj Invite Members i sidomenyn och sedan Add Members. Ange en eller flera e-postadresser, välj en roll i listan bredvid och välj Invite to Workspace:
- Creator kan skapa och ändra baser, tabeller och fält.
- Editor kan lägga till, ändra och ta bort poster, men inte ändra tabeller.
- Commenter kan läsa och kommentera, Viewer kan bara läsa.
Varje person får ett e-postmeddelande, "You've been invited to a Workspace", med Accept Workspace Invite, en länk till https://nocodb.example.com/signup/…. Där registrerar de sig med den adressen och ett eget lösenord, och ser baserna direkt.
Utan e-post använder du Admin Panel i stället: User Management > Invite User visar länken som du kopierar och skickar själv. Den som bjuds in så ser "You haven't been added to any workspace yet" tills du ger hen en roll: under Invite Members ändrar du No Access bredvid personen till en roll och väljer Confirm.
8. En bas med tabeller och länkar
En bas är en databas med tabeller i. Så här börjar du:
- På sidan Bases väljer du New Base, döper den till exempel till
Officeoch väljer Create Base. - Välj Create New Table, döp den till
Customersoch tryck Enter. Tabellen börjar med fältet Title. - Välj + efter den sista kolumnrubriken. Ge fältet ett namn, till exempel
Email, välj typen Email i listan och välj Save Field. Lägg tillPhonepå samma sätt, som Phone number. - I sidomenyn lägger Create New > Table till en andra tabell,
Projects. Ge denStatussom Single select med alternativenIdea,DoingochDone,Duesom Date,Budgetsom Currency,Paidsom Checkbox ochFilessom Attachment.
För att koppla varje projekt till en kund lägger du till fältet Customer i Projects med typen Link to another record. Välj Many to One, eftersom ett projekt har en kund och en kund kan ha många projekt, välj Customers under select table to link och välj Save Field. En cell i Customer erbjuder nu posterna i Customers, och varje kund får ett fält som listar kundens projekt.
Lägg till poster med New record längst ner i en tabell, eller skriv i den tomma raden. Pilen i början av en rad öppnar hela posten, med ett kommentarsfält bredvid.
Ett Formula-fält räknar ut ett värde från andra fält. Att jämföra ett datum med aktuell tid fungerar inte i 2026.09.1: {Deadline} > NOW() gav sant för både passerade och kommande deadlines. DATETIME_DIFF({Deadline}, NOW(), 'days') > 0 gav rätt svar.
9. Kanban, formulär och andra vyer
Varje tabell öppnas i en rutnätsvy. För att lägga till en vy håller du muspekaren över tabellen i sidomenyn och väljer dess +:
- Kanban frågar efter Stack by field; med
Statusblir varje alternativ en kolumn, och korten går att dra mellan dem. - Form gör ett formulär av tabellens fält, med en rubrik och en beskrivning som du kan ändra. Ta bort de fält som utomstående inte ska fylla i, till exempel
BudgetochPaid. - Gallery, Calendar och Map ingår också i gratisversionen; List, Timeline och Gantt kräver en betald licens.
Fields, Filter, Group och Sort ovanför en vy ändrar bara den vyn, så ett team kan ha ett rutnät med allt bredvid en vy med "mina öppna projekt".
10. Dela en vy och ett formulär
Share uppe till höger i en vy, och sedan Enable Public Viewing, skapar en länk som fungerar utan inloggning:
- För en rutnäts-, kanban- eller gallerivy visar länken vyn utan möjlighet att ändra, med de fält som vyn visar. I vårt test ändrades ingenting när vi skrev i en cell. Restrict access with password lägger till ett lösenord, och Allow Download, som är påslaget från början, låter besökare ladda ner raderna som CSV, JSON eller Excel; stäng av det om de bara ska titta.
- För en formulärvy låter länken till
https://nocodb.example.com/nc/form/…vem som helst skicka in en post. En testpost från ett privat fönster dök upp i tabellen direkt.
Stäng av Enable Public Viewing för att stoppa en länk. Share Base i samma dialog delar en hel bas; låt den vara avstängd om du inte menar det.
11. Bilagor
Ett fält av typen Attachment tar emot filer: öppna en post och välj Click to browse files, eller dra dit en fil, och välj sedan Upload 1 files. Varje fil får vara upp till 20 MB, och en cell rymmer upp till 10 filer. NC_ATTACHMENT_FIELD_SIZE och NC_MAX_ATTACHMENTS_ALLOWED i nocodb-app.container ändrar det.
Filerna hamnar i volymen nocodb-data, under nc/uploads. Med NC_SECURE_ATTACHMENTS=true svarar en fils fasta adress 404, och NocoDB delar ut länkar som slutar fungera efter ungefär två timmar, även i delade vyer.
För att lagra filerna i S3-lagring i stället, till exempel Garage på en annan server, använder du Admin Panel > Setup > Configure Storage, eller inställningarna NC_S3_ i NocoDB:s dokumentation. Det har vi inte testat.
12. API-token och REST-API:t
Varje tabell går att läsa och skriva via ett REST-API. Öppna kontomenyn, Account Settings > API Tokens > Create new token, ge token ett namn, till exempel scripts, och välj Create token. Token, som börjar med nc_pat_, visas en gång. Den har samma rättigheter som ditt konto, så hantera den som ett lösenord.
Adressen till en tabell i webbläsaren innehåller de id:n som API:t behöver: i https://nocodb.example.com/w35ooeyj/pbp18c1bsz41gj7/mjsj3tt04guwuig/… är delen efter arbetsytan som börjar med p basen, och nästa del, som börjar med m, tabellen. För att lista projekten, från valfri dator:
curl -s "https://nocodb.example.com/api/v3/data/pbp18c1bsz41gj7/mjsj3tt04guwuig/records?fields=Title,Status" \
-H "xc-token: nc_pat_..."
Svaret är JSON med en lista records. För att lägga till ett projekt:
curl -s -X POST "https://nocodb.example.com/api/v3/data/pbp18c1bsz41gj7/mjsj3tt04guwuig/records" \
-H "xc-token: nc_pat_..." -H 'Content-Type: application/json' \
-d '{"fields": {"Title": "Annual report", "Status": "Idea"}}'
Details > API Snippets ovanför en tabell visar färdiga exempel för just den tabellen. Ta bort en token du inte längre använder under API Tokens.
Webhooks (steg 13) går också att skapa via API:t, på /api/v2/meta/tables/…/hooks. Ge dem den brödtext som gränssnittet lägger till själv, "body": "{{ json event }}" i notification.payload. Utan den skickade NocoDB en tom POST i vårt test, och webhookens logg visade EMPTY_BODY.
13. Webhooks
En webhook anropar en adress du väljer när poster ändras, till exempel ett arbetsflöde i n8n. Ovanför en tabell väljer du Details > Webhooks > New Webhook. Välj händelse, till exempel After insert, eller behåll Send all events, ange adressen efter POST och välj Create Webhook. Test Webhook skickar ett exempel och visar felet om det misslyckas.
Varje anrop är en POST med JSON, till exempel "type": "records.after.insert" och de nya raderna under data. I vårt test kom den fram inom en sekund efter att en post lades till.
NocoDB vägrar webhook-adresser på privata nätverk, som localhost och 192.168.x.x, så att en webhook inte kan användas för att nå tjänster i ditt nätverk. En adress på internet, som https://n8n.example.com/webhook/…, fungerar.
Om n8n körs på samma server misslyckas anropet med connect ECONNREFUSED, och en AddHost-rad hjälper inte, eftersom NocoDB vägrar även den privata adressen. Ge användaren nocodb filen containers.conf från Podman-guiden, steg 8, och starta om podden med systemctl --user restart nocodb-pod.
14. Använd NocoDB på svenska
NocoDB har ett svenskt gränssnitt, översatt med AI, vilket märks på några konstiga ord: baser kallas "Projekt". Varje användare väljer Svenska i språkmenyn uppe till höger under Account Settings. Namnen på dina egna tabeller och fält blir som du skrev dem.
15. Externa anslutningar
Vi avlyssnade serverns DNS-uppslagningar och utgående anslutningar medan NocoDB startade, medan användare bjöds in och medan stegen ovan gjordes. Förutom Docker Hub, när avbilderna laddades ner, dök ett namn upp: api.github.com. När någon öppnar NocoDB frågar servern GitHub efter den senaste versionen, för att visa Upgrade available högst upp under Account Settings. Vi hittade ingen inställning som stänger av det.
I webbläsaren laddar NocoDB:s sidor ett skript från app.chatwoot.com, en supportchatt som drivs av Chatwoot, Inc., även med chatten avstängd. Raden header från steg 5 blockerar det. Med NC_DISABLE_TELE, NC_DISABLE_ERR_REPORTS och NC_DISABLE_SUPPORT_CHAT skickade NocoDB ingen användningsstatistik och inga felrapporter i vår avlyssning. teleEnabled och errorReportingEnabled är båda false i https://nocodb.example.com/api/v1/meta/nocodb/info när du är inloggad.
Webhooks anropar de adresser du anger, och AI-funktionerna, om du köper dem, använder de tjänster du sätter upp.
Säkerhetskopiera
Som nocodb:
umask 077
mkdir -p ~/backup
podman exec nocodb-db pg_dump -U nocodb -Fc nocodb > ~/backup/nocodb-db.dump
podman volume export nocodb-data > ~/backup/nocodb-data.tar
podman secret inspect --showsecret --format '{{.SecretData}}' nocodb-jwt-secret > ~/backup/jwt-secret.txt
Databasen innehåller tabeller, poster, användare, vyer, delade länkar, API-token och webhooks; volymen innehåller de uppladdade filerna. Dumpen körs medan NocoDB fortsätter att fungera. Kopiera ~/backup till en annan maskin, till exempel med restic, och förvara den säkert: den innehåller all er data.
För att återställa till en tom pod, som nocodb, med säkerhetskopian i ~/backup:
systemctl --user stop nocodb-pod
podman volume rm nocodb-db nocodb-data
podman volume create nocodb-data
podman volume import nocodb-data ~/backup/nocodb-data.tar
systemctl --user start nocodb-db
podman exec -i nocodb-db pg_restore -U nocodb -d nocodb --no-owner < ~/backup/nocodb-db.dump
systemctl --user start nocodb-app
Genom att bara starta databasen först läses säkerhetskopian in innan NocoDB sätter upp en tom databas. Efter vår återställning fungerade poster, filer, användare och API-token. På en ny server skapar du inloggningsnyckeln från säkerhetskopian i stället för en ny i steg 2, så att ingen loggas ut:
tr -d '\n' < ~/backup/jwt-secret.txt | podman secret create nocodb-jwt-secret -
Uppdatera
NocoDB släpper en ny version varannan till var tredje vecka, med versionsinformation på sin GitHub-sida. För att uppdatera, som nocodb, gör du först en säkerhetskopia, byter sedan versionen på raden Image= i nocodb-app.container, till exempel till 2026.10.0, och startar om:
systemctl --user daemon-reload
systemctl --user restart nocodb-app
podman image prune -a -f
NocoDB uppdaterar sin databas när den startar. podman image prune -a tar bort den gamla avbilden, som tar omkring 900 MB, men behåller avbilderna som dina containrar använder. Utan -a blir den gamla avbilden kvar, eftersom den fortfarande har sin versionstagg. Vi uppdaterade från 2026.09.0 till 2026.09.1 på det här sättet, och data och inloggningar fanns kvar.
PostgreSQL uppdaterar sig själv inom version 17. För att gå till en nyare huvudversion av PostgreSQL behöver du göra en dump och återställa den, som under Säkerhetskopiera.
Felsökning
curl skriver ut Cannot GET /api/v1/health. NocoDB startar fortfarande. Vänta en minut; podman logs nocodb-app slutar med "App started successfully." när den är klar.
Främlingar kan registrera sig. Allow signup only using invite url är inte ikryssad, steg 4. Ta bort konton du inte känner igen under Admin Panel > User Management.
En ny användare ser "You haven't been added to any workspace yet". Hen har ingen roll än. Ge hen en under Invite Members, steg 7.
"Please check your email to reset the password", men inget e-postmeddelande kommer. E-post är inte uppsatt, steg 6. Superadministratören kan fortfarande bjuda in personer med en kopierad länk.
Alla loggas ut efter en omstart. Raden Secret=nocodb-jwt-secret saknas, så NocoDB skapar en ny nyckel varje gång den startar.
En webhook anropas aldrig. Test Webhook visar varför. "Connection to a private network IP is blocked for security reasons" betyder att adressen ligger på ett privat nätverk, vilket NocoDB vägrar (steg 13). connect ECONNREFUSED för en app på den här servern betyder att användaren nocodb saknar den containers.conf som steg 13 beskriver.