# HumHub

Generated on 8 Dec 2021 from [the HumHub catalog page](https://marketplace.digitalocean.com/apps/humhub)

HumHub is an open-source Enterprise Social Network. Easy to install, intuitive and adaptable with countless free modules. Available as on-premise or SaaS solution. Boost communication and knowledge transfer in your organization. Keep hands on your data with your own Enterprise Social Network.

## Software Included

| Package | Version | License |
|---|---|---|
| [HumHub](https://www.humhub.com/) | 1.10.2 | AGPL-3 |

## 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=humhubgmbhkg-humhub-10)

## Creating an App using the API

In addition to creating a Droplet from the HumHub 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 HumHub 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":"humhubgmbhkg-humhub-10"}' \
        "https://api.digitalocean.com/v2/droplets"
```

## Getting Started After Deploying HumHub

After you create your HumHub One-Click Droplet:

- Briefly visit the Droplet via SSH `ssh root@your_droplet_public_ipv4` to display the required **Database configuration**.
- Then visit http://your\_droplet\_public\_ipv4 in the browser and start the HumHub initial installation.

## Individual Hostname with SSH

To use a custom hostname e.g. `test.example.com` instead of the droplet IP, the following steps are necessary.

Please make sure to always replace the example hostname with your own hostname.

1. Create a DNS record for your hostname that pointing to your new Droplet\_IP
2. Run certbot to obtain a SSL certificate e.g. `certbot certonly -a webroot -w /var/www/html -d test.example.com`
3. Adjust hostname and SSL in NGINX configuration `/etc/nginx/sites-available/humhub.conf`. (See related `HINTS` in the file.)
4. Restart NGINX with `systemctl restart nginx`
5. Change the default URL in the HumHub configuration. To do this, change the `Base URL` field in `Administration` -> `Settings` -> `General`.