Skip to content

IT / System Administrator

Last Updated: February 2026

Your hub for everything you need as the IT manager or system administrator at Scott Recycling. This page covers user management, system configuration, server administration, troubleshooting, and the tools you use every day.


Get Started

  1. Getting Started with Odoo — Login and navigation basics
  2. Developer Guide — Module reference, server management, deployment, coding standards
  3. Server Reference — Service management, configuration, logs

Your Daily Apps

App What You'll Do There Guide
Settings Manage users, access rights, groups, system configuration Getting Started
Helpdesk Handle IT tickets — password resets, access requests, system issues Helpdesk Guide
SR Operations Monitor system health, check for alert issues KPI Overview
All Modules Install, upgrade, and configure any Odoo module Module Reference
Documents (DMS) Manage company document storage, directories, access groups Document Management Guide
Dashboards Configure and monitor business intelligence dashboards Dashboards Overview
Attendance Manage attendance configuration, review records Attendance Guide
Website Website builder, online store, SEO pages, FAQ system Website Overview · Storefront
Scott AI (Sam) Configure and monitor AI phone system and website chat AI Phone System · Website Chat
Recruitment Configure recruitment pipeline, manage job postings Recruitment Guide
Time Off Configure time off types, manage allocations Time Off Guide
BI SQL Editor Create custom SQL-based reports and dashboard views BI SQL Editor Guide
MIS Builder Build financial KPI reports with accounting expressions MIS Builder Guide
Gamification Configure goals, badges, challenges for employee motivation Gamification Guide
Skills & Resume Configure skill types, levels, and employee CV generation Skills & Resume Guide
Course Management Set up and manage training courses and schedules Course Management Guide
Email Configuration Manage outgoing/incoming mail servers, fix delivery issues Getting Started

How Do I...?

User Management

Task Where to Go Steps
Create a user account Settings → Users & Companies → Users → New Enter name, email (used as login), set password. Assign access rights and groups based on role. Save.
Reset a password Settings → Users → Select user → Action → Change Password Enter the new password. Notify the user securely. They should change it on first login.
Deactivate a user Settings → Users → Select user → Archive Archiving disables the login without deleting data. Use this for departing employees.
Manage access rights Settings → Users → Select user → Access Rights tab Assign groups for each app (e.g., Sales: User, Inventory: Manager). See the role's Position Profile for the correct groups.
Add a user to a group Settings → Technical → Groups → Select group → Users tab → Add This gives the user all permissions associated with that group.
View login history Settings → Technical → Logging Check recent login attempts, failed logins, and session activity.

System Administration

Task How to Do It
Install a module Settings → Apps → Search for module → Install. Or from CLI: /opt/odoo17/odoo17-venv/bin/python3 /opt/odoo17/odoo17/odoo-bin -c /etc/odoo17.conf -d test1 -u MODULE_NAME --stop-after-init
Upgrade a module Same as install but use the Upgrade button in the UI or -u MODULE_NAME flag in the CLI command above
Restart the Odoo service SSH into the server: sudo systemctl restart odoo17.service
Check server logs sudo journalctl -u odoo17.service --since "5 minutes ago" --no-pager \| tail -50
Check Odoo configuration Review /etc/odoo17.conf for database settings, addons path, and server options
Monitor disk usage df -h for overall, du -sh /path/to/directory for specific directories
Check database size sudo -u postgres psql -c "SELECT pg_size_pretty(pg_database_size('test1'));"
Backup the database Follow the backup procedure in the Deployment Guide

Workstation Setup

Task Steps
Set up a new workstation Install the browser (Chrome or Firefox recommended). Bookmark the Odoo URL. Set up the user account (see above). Test login. Configure printer access if needed.
Configure email for a user In Odoo: Settings → Technical → Email → Aliases. For Outlook/Gmail: configure the user's email client with company SMTP settings.
Set up a barcode scanner Connect the USB scanner. Test it reads to a text field. No driver installation is typically needed — most scanners emulate keyboard input. Configure the scanner prefix/suffix if required by the Portal Inventory module.
Troubleshoot a user login issue Check if the account is archived. Reset the password. Clear browser cache. Try incognito mode. Check the server logs for error messages.

Troubleshooting

Problem Diagnostic Steps
User cannot log in Check if account is active (not archived). Reset password. Check browser (clear cache, try incognito). Check server logs for errors.
Module not working after upgrade Check server logs for Python tracebacks. Restart the service. Try upgrading the module again from CLI with --stop-after-init. Check for dependency issues.
Slow performance Check server CPU and memory (htop). Check PostgreSQL query times. Check for long-running cron jobs. Review the Odoo log for slow queries.
Email not sending Check Settings → Technical → Email → Emails for failed messages. Verify outgoing mail server configuration. Check for SMTP authentication errors in logs.
Scheduled action not running Settings → Technical → Automation → Scheduled Actions. Check if the action is active, when it last ran, and if there are errors in the log.
Access error for a user Check the user's groups and access rights. Compare with another user who has the correct access. Review the error message — it usually names the missing group or permission.

Server Quick Reference

Item Value
Odoo URL localhost:1818 (local)
Database test1
Odoo Core /opt/odoo17/odoo17/
Custom Addons /home/dan/SR-Odoo/
Virtual Environment /opt/odoo17/odoo17-venv/
Config File /etc/odoo17.conf
Service odoo17.service
Python 3.12.3
PostgreSQL 14
OS Ubuntu 24.04 (Noble)

Training and References

Resource What It Covers
Developer Guide Module development, coding standards, architecture overview
Module Reference All custom modules, their purpose, and dependencies
Server Reference Service management, configuration files, log analysis
Deployment Guide Deployment procedures, backups, server setup
Debugging Guide Troubleshooting techniques, common errors, log analysis
Coding Standards Code style, naming conventions, module structure
Employee Handbook Company policies, safety rules, timekeeping

Questions? Check the Developer Guide first, then ask the operations manager or general manager.