Odoo Klantportaal — SSH Toegangsgids

Deze gids legt uit hoe je verbinding maakt met je Odoo-server, je aangepaste modules (addons) beheert en de Odoo-applicatie bedient met de appcmd command-line tool.

Voordat je begint: Vervang in deze gids odoo.yourwebhoster.net door de servernaam die aan je is doorgegeven, en vervang username door de gebruikersnaam die aan je is doorgegeven.

Verbinding maken via SSH

Maak verbinding met je Odoo-server via je SSH-sleutel en de domeinnaam:

ssh username@odoo.yourwebhoster.net

Je gebruikersnaam en SSH-sleutel worden ingesteld door je hostingprovider. Je hebt geen wachtwoord nodig.

Eerste login

Na het verbinden zie je een welkomstbericht met de instanties waartoe je toegang hebt en de beschikbare commando's:

============================================
  Odoo Customer Portal
============================================

  Instance  : odoo-yourwebhoster
  URL       : odoo.yourwebhoster.net
  Addons    : ~/addons-odoo-yourwebhoster  (upload custom modules here)

  Commands:
    appcmd status odoo.yourwebhoster.net
    appcmd restart odoo.yourwebhoster.net
    appcmd logs odoo.yourwebhoster.net
    appcmd logs -f odoo.yourwebhoster.net
    appcmd logs 200 odoo.yourwebhoster.net

  Run 'appcmd' without arguments for help.

Als je toegang hebt tot meerdere instanties, wordt elke instantie apart vermeld.

Aangepaste modules beheren

De addons-map is beschikbaar als snelkoppeling in je thuismap:

~/addons-odoo-yourwebhoster  →  de addons-map voor odoo.yourwebhoster.net

Zet je aangepaste Odoo-modules hier neer. Elke module is een submap met een Odoo-modulestructuur (met __manifest__.py). Voorbeeld:

~/addons-odoo-yourwebhoster/
├── mijn_module/
│   ├── __init__.py
│   ├── __manifest__.py
│   └── models/
└── andere_module/
    ├── __init__.py
    └── __manifest__.py

Bestanden uploaden

Gebruik scp of een SFTP-client naar keuze (FileZilla, Cyberduck, WinSCP, VS Code Remote-SSH).

scp — een modulemap uploaden:

scp -r ./mijn_module username@odoo.yourwebhoster.net:~/addons-odoo-yourwebhoster/

rsync — synchroniseren en overschrijven:

rsync -avz ./mijn_module/ username@odoo.yourwebhoster.net:~/addons-odoo-yourwebhoster/mijn_module/

Na het uploaden van een nieuwe of bijgewerkte module moet je de Odoo-container herstarten zodat de wijzigingen worden opgepikt (zie Odoo herstarten hieronder).

appcmd gebruiken

appcmd is de command-line tool voor het beheren van je Odoo-instantie. Alle commando's nemen de Odoo-domeinnaam als laatste argument.

appcmd <commando> [opties] <hostname>

Voer appcmd zonder argumenten uit om de beschikbare commando's en de instanties waartoe je toegang hebt te bekijken.

Status controleren

Laat zien of de Odoo- en databasecontainers actief zijn:

appcmd status odoo.yourwebhoster.net

Voorbeelduitvoer:

Container status for odoo-yourwebhoster:
NAME                          IMAGE                          STATUS
odoo-yourwebhoster_odoo       ghcr.io/.../odoo-enterprise    Up 2 hours (healthy)
odoo-yourwebhoster_postgres   postgres:16                    Up 2 hours (healthy)

Odoo herstarten

Herstart de Odoo-container. Doe dit nadat je nieuwe of bijgewerkte modules hebt geüpload:

appcmd restart odoo.yourwebhoster.net

Dit herstart de Odoo-container en toont de status zodra deze opgestart is. De database wordt niet beïnvloed — alle gegevens blijven behouden.

Let op: Alleen de Odoo-container wordt herstart. De databasecontainer blijft de hele tijd actief.

Logs bekijken

Laatste 100 regels (standaard):

appcmd logs odoo.yourwebhoster.net

Laatste N regels:

appcmd logs 500 odoo.yourwebhoster.net

Live meekijken (nieuwe regels worden direct getoond, stoppen met Ctrl+C):

appcmd logs -f odoo.yourwebhoster.net

Snelle overzicht

Problemen oplossen

Odoo reageert niet na een herstart

Wacht 30–60 seconden na het uitvoeren van appcmd restart — Odoo voert een initialisatie uit bij het opstarten. Controleer met appcmd status of de container healthy toont voordat je het in de browser test.

Als de status langer dan 2 minuten starting toont, bekijk dan de logs:

appcmd logs 200 odoo.yourwebhoster.net

Zoek naar Python-foutmeldingen of ModuleNotFoundError, wat wijst op een probleem met een aangepaste module.

Mijn module verschijnt niet in Odoo

1. Controleer of de modulemap correct is geüpload en een geldig __manifest__.py bevat
2. Voer appcmd restart odoo.yourwebhoster.net uit om de modulelijst te vernieuwen
3. Ga in Odoo naar Instellingen → Ontwikkelaarsmodus activeren, daarna Apps → Apps-lijst bijwerken
4. Zoek je module op technische naam (de mapnaam)

Toestemming geweigerd bij het uploaden

Zorg ervoor dat je uploadt naar ~/addons-odoo-yourwebhoster/ (de snelkoppeling in je thuismap) en niet rechtstreeks naar /opt/apps/. Het pad ~/addons-odoo-yourwebhoster is de enige schrijfbare locatie voor addons.

Ik kan geen verbinding maken via SSH

• Controleer of je de juiste SSH-sleutel gebruikt (de sleutel die is geregistreerd bij je provider)
• Controleer de hostnaam: odoo.yourwebhoster.net
• Zorg ervoor dat je SSH-client geen wachtwoord gebruikt (alleen sleutelgebaseerde authenticatie)

Neem contact op met yourwebhoster.eu als het probleem aanhoudt.