:show-content: ======= General ======= .. toctree:: general/users general/export_import_data general/multi_companies general/auth general/tags general/payment_acquirers general/voip general/in_app_purchase general/unsplash **Odoo** is a suite of open source business apps that cover all your company needs: :doc:`CRM `, :doc:`eCommerce `, :doc:`accounting `, :doc:`inventory `, :doc:`point of sale `, :doc:`project management `, etc. Its unique value proposition is to be at the same time *very easy* to use and *fully integrated*. This section of the documentation covers all functional aspects that aren't app-specific. You can find, for example, information about: - :doc:`general/users` and :doc:`general/users/access_rights`, to configure each user correctly. - :doc:`general/export_import_data`, to transfer data from and to other environments than Odoo or update data. - :doc:`general/payment_acquirers`, to allow your customers to pay with their favorite payment method. - :doc:`general/auth/google`, as an authentication method. .. important:: - | **Installing or uninstalling apps, managing users, etc., is up to you.** | As the administrator of your database, you are responsible for its usage, as you know best how your organization works. This includes the installation or uninstallation of :ref:`apps ` as well as the number of :doc:`users ` currently in use. - | **Odoo apps have dependencies.** | Installing some apps and features with dependencies may also install additional apps and modules that are technically required, even if you won't actively use them. - | **Always test app installation/removal on a duplicate of your database.** | This way, you can know what app dependencies may be required or what data may be erased. .. seealso:: - :ref:`Online Database management: Duplicate a database ` - :ref:`On-premises Database management: Duplicate a database ` - `Submit a Support Ticket `_ .. _general/apps-modules: Apps and modules ================ You can :ref:`install `, :ref:`upgrade ` and :ref:`uninstall ` all apps and modules from the :menuselection:`Apps` dashboard. By default, an *Apps* filter is applied. If you want to search for modules (including :doc:`Fiscal Localization Packages `), click on *Filters* and select *Extra*. .. image:: general/apps-search-filter.png :align: center :alt: Add "Extra" filter in Odoo Apps .. warning:: Odoo is *not a smartphone*, and its apps shouldn't be installed or uninstalled carelessly. Apply caution when adding or removing apps and modules on your database since this may impact your subscription costs. .. _general/install: Install apps and modules ------------------------ Go to :menuselection:`Apps`, and click on the *Install* button of the app you want to install. .. note:: If the module you are looking for is not listed, you can **update the app list**. To do so, activate the :ref:`developer mode `, then go to :menuselection:`Apps --> Update Apps List` and click on *Update*. .. _general/upgrade: Upgrade apps and modules ------------------------ On some occasions, new improvements or app features are added to :doc:`supported versions of Odoo `. To be able to use them, you must **upgrade** your app. Go to :menuselection:`Apps`, click on the *dropdown menu* of the app you want to upgrade, then on *Upgrade*. .. _general/uninstall: Uninstall apps and modules -------------------------- Go to :menuselection:`Apps`, click on the *dropdown menu* of the app you want to uninstall, then on *Uninstall*. .. image:: general/uninstall.png :align: center Some apps have dependencies, meaning that one app requires another. Therefore, uninstalling one app may uninstall multiple apps and modules. Odoo warns you which dependant apps and modules are affected by it. .. image:: general/uninstall_deps.png :align: center To complete the uninstallation, click on *Confirm*. .. danger:: Uninstalling an app also uninstalls all its dependencies and permanently erases their data. .. _developer-mode: Activate the developer mode (debug mode) ======================================== The developer mode (or debug mode) gives you access to extra and advanced tools. Through the Settings -------------------- Go to :menuselection:`Settings --> Activate the developer mode`. .. image:: general/settings.png :align: center :alt: Overview of the debug options under settings in Odoo .. note:: *Activate the developer mode (with assets)* is used by developers; *Activate the developer mode (with tests assets)* is used by developers and testers. Once activated, the *Deactivate the developer mode* option becomes available. Through a browser extension --------------------------- | Go to the settings and extensions of your web browser, and search for *Odoo Debug*. Once the extension is installed, a new icon will be shown on your toolbar. | For the *Odoo Debug* extension, a single click enables a normal version of the mode, while a double click enables it with assets. To deactivate it, use a single click. .. image:: general/monkey.png :align: center :alt: View of odoo’s debug icon in a chrome’s toolbar Through the URL --------------- In the URL add ``?debug=1`` or ``?debug=true`` after *web*. .. image:: general/url.png :align: center :alt: Overview of an url with the debug mode command added in Odoo .. tip:: Developers: type ``?debug=assets`` and activate the mode with assets. Locate the mode tools --------------------- The Developer mode tools can be accessed from the *Open Developer Tools* button, located on the header of your pages. .. image:: general/button_location.png :align: center :alt: Overview of a console page and the debug icon being shown in Odoo Mobile Push Notifications ========================= As of Odoo 12.0, 13.0 or above, there is no more complex configuration to enable push notifications in the mobile app. Simply go to :menuselection:`Settings --> General Settings --> Odoo Cloud Notification (OCN)` and make sure that **Push Notifications** is checked.