# OpenBoxes Server

Generated on 1 Mar 2026 from [the OpenBoxes Server catalog page](https://marketplace.digitalocean.com/apps/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

| Package | Version | License |
|---|---|---|
| OpenBoxes | 0.9.6-hotfix1 | |
| Apache Tomcat | 9.0.115 | |
| Azul Zulu JDK | 8 | |
| MySQL | 8.0 | |
| Nginx | 1.24 | |
| Certbot | 2.9.0 | |

## 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.

[![Deploy to DO](https://www.deploytodo.com/do-btn-blue.svg)](https://cloud.digitalocean.com/droplets/new?image=openboxes-openboxesserver)

## 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](https://docs.digitalocean.com/reference/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](https://docs.digitalocean.com/reference/api/create-personal-access-token/index.html.md) to an environment variable or substitute it in the command below.

```shell
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](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](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](https://github.com/openboxes/openboxes/releases/)
- [Announcements](https://community.openboxes.com/c/announcements/12)

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

[https://docs.openboxes.com/en/latest/upgrading/](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](https://community.openboxes.com)