OpenBoxes Server

OpenBoxes enables organizations to:

1. Issue purchase orders and report on historical purchase information
2. Track goods from purchase order through shipment, receipt, and invoice
3. Manage inventory, including lot and expiry tracking and bin location tracking
4. Manage distribution to and within facilities using custom stock lists
5. Track stock requests and calculate true demand based on request data
6. Generate forecasts incorporating orders, expected ship dates, inventory, and demand
7. Connect directly to the database to develop and disseminate custom reports

Software Included

Creating an App using the Control Panel

Click the Deploy to DigitalOcean button to create a Droplet based on this 1-Click App. If you aren’t logged in, this link will prompt you to log in with your DigitalOcean account.

Creating an App using the API

In addition to creating a Droplet from the OpenBoxes Server 1-Click App using the control panel, you can also use the DigitalOcean API. As an example, to create a 4GB OpenBoxes Server Droplet in the SFO2 region, you can use the following curl command. You need to either save your API access token) to an environment variable or substitute it in the command below.

curl -X POST -H 'Content-Type: application/json' \
         -H 'Authorization: Bearer '$TOKEN'' -d \
        '{"name":"choose_a_name","region":"sfo2","size":"s-2vcpu-4gb","image": "openboxes-openboxesserver"}' \
        "https://api.digitalocean.com/v2/droplets"

Getting Started After Deploying OpenBoxes Server

Getting Started

Connecting to your instance

Connect to your droplet via SSH

ssh root@your_droplet_public_ipv4

NOTE: It’s recommended that you add your public key to your droplet.

Connect to your droplet via HTTP

http://your_droplet_public_ipv4

Logging in

To get started, log in using the default credentials (admin:password) and choose the Main Warehouse location.

Securing your account

Once logged in, it is recommended that you change the admin user’s password.

Securing your server

Please note that your connection to the application is not secure. It is recommended that you enable HTTPS.

In order to enable HTTPS using Apache, please review the following instructions:

https://www.digitalocean.com/community/tutorials/how-to-secure-apache-with-let-s-encrypt-on-ubuntu-22-04

Getting Started

Review the instructions in the following discussion forum post to help you get started with the software.

https://discuss.openboxes.com/t/openboxes-1-click-app-install-via-digitalocean-marketplace/311

Upgrading

Keep an eye out for new releases (as well as release notes)

• Releases
• Announcements

Once a new version has been released, use the following instructions to upgrade your instance.

https://docs.openboxes.com/en/latest/upgrading/

NOTE: It is highly recommended that you backup your database or take a snapshot of your droplet before upgrading. Enabling droplet backups through DigitalOcean is also recommended.

Support

If you encounter any issues or would like to leave feedback, please join our community support forum:

https://community.openboxes.com