https://docs.msupply.org.nz/docs/ 2026-04-06T16:44:00+00:00 https://docs.msupply.org.nz/docs/ https://docs.msupply.org.nz/docs/_media/wiki:logo.png text/html 2025-11-05T03:57:05+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.msupply.org.nz/docs/admin:automatic_updates 25.07. Updating mSupply Updates for mSupply are being released frequently. The method of update varies with the type of mSupply that you have: * The mSupply server must be manually updated by an administrator. Contact <support@msupply.foundation> if you need help. * The mSupply client will update automatically from the mSupply server when it is first opened after a server update - see text/html 2024-08-05T00:33:45+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.msupply.org.nz/docs/admin:backup_and_restore 25.06. Backup If your data is important, then data backups need to happen, because things can go wrong (power failures, disk failures, ransomware, etc.) * You can perform a backup manually and/or automatically. Automatic backups should be scheduled to run frequently (every day), manual backups should be done before updates or other potentially risky changes. text/html 2022-02-08T14:41:46+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.msupply.org.nz/docs/admin:deployment 25.14. mSupply deployment This document gives an overview of the process of installing mSupply at a new location. Terms * A virtual store will usually map to a physical location- either a separate warehouse or an entity within a warehouse that has it's own items and facilities and transactions text/html 2021-10-08T11:12:48+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.msupply.org.nz/docs/admin:diagnostics 25.09. Diagnostics This feature is primarily intended for use by our technical staff when there is reason to believe that there may be some errors in the database; it is unlikely to be of practical use to users of mSupply. However, feel free to run some checks if you're bored or need help to get to sleep text/html 2021-10-08T11:13:19+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.msupply.org.nz/docs/admin:dispensary_installation 25.12. mSupply dispensary installation mSupply provides a fully featured Pharmacy Dispensary module. The following steps describe how to configure mSupply for Dispensary use. This document specifically applies to Pharmacy Dispensary staff. Users text/html 2021-10-08T11:12:55+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.msupply.org.nz/docs/admin:finalising_transactions 25.10. Finalising transactions There are three methods of finalising invoices: * The method described here. * By highlighting transactions in the transaction list and clicking Finalise * By checking the Finalise checkbox when viewing a particular invoice and clicking text/html 2021-10-08T11:13:10+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.msupply.org.nz/docs/admin:managing_data_files 25.11. Managing data files File > New data file... This command will present you with a standard open/save window where you can choose the name and location of a new data file: If you click the OK button, mSupply will close the data file currently in use (saving any changes made automatically), and then open the new data file. The new data file will contain no items, names or transactions. You can either enter these manually or use the import commands (see later in this chapter) to import item… text/html 2026-01-05T09:30:29+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.msupply.org.nz/docs/admin:managing_users 25.15. Managing users About users and groups mSupply has a comprehensive system of controlling user access, allowing you to manage in fine detail what each user can do and see in the system. You can manage users individually, in groups or a mixture of both - whichever is most suitable for your situation. text/html 2026-02-26T23:31:35+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.msupply.org.nz/docs/admin:printer_installation 25.18. Label printer hardware setup ZD421 We recommend Zebra ZD421t 203dpi label printer with a network port (which has replaced the older Zebra GK420t) . ZD421 User guide It is very important to order the 203dpi model of the ZD421t, as the 300dpi model will not work correctly with our code. text/html 2021-10-08T11:14:07+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.msupply.org.nz/docs/admin:purging 25.17. License management On any mSupply server, you have concurrent user licenses. When a user logs in, they take one of these licenses, when they logout the license is returned. These licenses sit in a single pool, to be used by all users who login to that server. text/html 2021-10-08T11:12:10+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.msupply.org.nz/docs/admin:schedules_periods 25.04. Schedules and periods Schedules and periods Schedules are regular timeframes (e.g. monthly, fortnightly) that may be used for cyclical operations, such as program orders (special types of requisitions). There is no limit to the number of schedules. text/html 2022-11-29T13:13:42+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.msupply.org.nz/docs/admin:server_administration 25.13. mSupply server administration mSupply server provides a number of administrative features that enable fine-tuning and robust management of the system. The server can run as an application or as a service. Running it as a service has a lot of benefits, such as automatic restart when the server machine is restarted, but, for technical reasons, this is not always possible. Here's how you administer the server depending on how it is running. text/html 2023-08-11T01:54:56+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.msupply.org.nz/docs/admin:server_installation_2 25.02. mSupply client / server installation part 2 These steps need to be carried out after completing the steps described in: 25.01. mSupply client / server installation part 1 Install associated server application software It can be useful to Install Dropbox first so that you can use the Dropbox folder to transfer software and files to the server. But if the internet connection is fast enough, it is easier to start with text/html 2025-12-02T04:54:49+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.msupply.org.nz/docs/admin:server_installation_3 25.03. mSupply client / server installation part 3 These steps need to be carried out after completing the steps described in: 20.01 mSupply client/server installation part 1 20.02 mSupply client/server installation part 2 Obtaining a data file If you are setting up a sync site for a synced system, then you will need to: * Generate the XML file for the sync site from the central server - refer text/html 2024-04-25T06:42:41+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.msupply.org.nz/docs/admin:server_installation 25.01. mSupply client / server installation part 1 * mSupply Server can be installed on a range of Windows OS hardware platforms. Installations of the mSupply Server and client software on these different platforms will not be identical. * This page includes instructions for installing the mSupply Server and client software on a typical Windows 10 Pro platform. This will include many hardware configuration issues as these have been known to be important for mSupply Server operation and tr… text/html 2021-10-08T11:14:39+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.msupply.org.nz/docs/admin:server_troubleshooting 25.20. Server troubleshooting Service not running If the client is unable to connect to the server, it is quite possible that the mSupply Server Service is not running. You can check by going into Control Panel>Administrative Tools>Services Look for the service named 4D. The status should be text/html 2021-10-08T11:13:59+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.msupply.org.nz/docs/admin:show_users 25.16. Show connected users Note: Not applicable when running mSupply in single user mode To display a list of users currently logged on to mSupply, select Special > Show connected users (Ctrl + Shift + U). The window below is displayed. Messaging other users text/html 2021-10-08T11:15:39+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.msupply.org.nz/docs/admin:tables_fields 25.22. Field descriptions For descriptions of individual mSupply fields please refer to section 24. Data Tables and Fields Previous: 25.21. Help menu | | Next: 26. Other Topics text/html 2023-01-24T09:53:49+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.msupply.org.nz/docs/admin:the_log 25.19. The system log The log contains records of who did what and when in the system. It's a useful place to look to find out what happened to certain records and when certain things were done. Some events (lots!) are always logged by mSupply but some are optional and are chosen in the text/html 2021-10-08T11:19:57+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.msupply.org.nz/docs/admin:updating 25.21. Help menu Help > About mSupply Choosing this item displays information about your mSupply installation. Authorisation The Authorisation button is provided largely for our support team to assist with resolving any issues. You can safely ignore it. text/html 2021-10-08T11:12:42+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.msupply.org.nz/docs/admin:user_tasks 25.08. Changing users and passwords Changing the current user From the menus choose File > Change User... (Keyboard shortcut Ctrl+1) This logs out the current user and re-opens the login window so that the new user can login, without having to close and reopen mSupply: text/html 2021-10-08T11:12:21+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.msupply.org.nz/docs/admin:web_browser_access_via_ts-plus 25.05. Web browser access via TSPlus Accessing mSupply If TSPlus has been set up on your mSupply Server, then client sessions can connect to it using a web browser. Open a web browser, then: * Enter the name or IP address of the server in the URL / search bar. It