---
title: "Deploy HumHub: Self-Hosted Social Intranet & Enterprise Network"
description: "Run a private social network with spaces, posts and modules."
category: "Other"
url: https://railway.com/deploy/humhub-social-intranet
---

# Deploy HumHub: Self-Hosted Social Intranet & Enterprise Network

Run a private social network with spaces, posts and modules.

**[Deploy HumHub: Self-Hosted Social Intranet & Enterprise Network on Railway](https://railway.com/template/humhub-social-intranet)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/humhub-social-intranet/manifest.json

- **Creator:** blueorange
- **Category:** Other

## Template content

### MySQL https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/svg/mysql.svg

- **Image:** mysql:9.4
- **Start command:** `docker-entrypoint.sh mysqld --innodb-use-native-aio=0 --disable-log-bin --performance_schema=0 --innodb-buffer-pool-size=1G`

### mailpit https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/svg/mailpit.svg

- **Image:** axllent/mailpit:latest
- **Health check:** /livez
- **Public domain:** Yes

### humhub https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/svg/humhub.svg

- **Source:** https://github.com/gridalpha/humhub-railway
- **Health check:** /user/auth/login
- **Public domain:** Yes

## Documentation

# Deploy and Host HumHub on Railway

![HumHub logo](https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/svg/humhub.svg)

HumHub is an open source **social network and intranet** for companies, associations, schools and communities. People join spaces for teams or projects, share posts, files and polls in an activity stream, comment and like, follow each other, and get notified about what matters. A marketplace of modules adds a wiki, calendar, tasks, messenger, gallery and more. HumHub is dual-licensed: the community edition is AGPL-3.0-only, with a paid Professional Edition. It has about 6,800 GitHub stars, and 1.19.4 shipped in November 2026. This template runs the official HumHub image on its stable channel with MySQL 9.4 and a Mailpit inbox for testing email, installs the database and creates the admin account before the site goes live. Slack Pro costs $8.75 per user per month billed monthly. HumHub on Railway costs about $10–15/month for your whole network.

---

## What This Template Deploys

| Service | Purpose |
|---|---|
| **HumHub** | The official `humhub/humhub:stable` image (currently 1.19) with a boot wrapper, FrankenPHP on port `8080` with a public domain. Web app, cron scheduler and two queue workers. Volume at `/data` for uploads, config, modules and themes. |
| **MySQL** | `mysql:9.4`, private only. Volume at `/var/lib/mysql` holds users, spaces, posts and settings. |
| **Mailpit** | `axllent/mailpit`, a test inbox with its own public domain behind a generated password. HumHub's outgoing mail goes here instead of to real inboxes. |

On first boot the wrapper waits for MySQL, installs the database, writes the site config, creates the admin account and sets the base URL before the public URL serves anything, so nobody can claim an unfinished setup wizard.

---

## About Hosting HumHub

Email threads and chat channels are poor places to keep a company's knowledge, announcements and team spaces. Hosted social intranets charge per user and keep your internal conversations on their servers. HumHub gives you a private social network on your own domain.

**Spaces.** Create open or private spaces for teams, departments, projects or interest groups, each with its own stream, members and modules.

**Activity stream.** Posts with files, mentions, topics and polls, plus comments, likes and pinned content.

**Profiles and directory.** User profiles with custom fields, a people directory, following and friendships.

**Notifications.** Web and email notifications with per-user settings, plus a daily or weekly digest.

**Modules.** Add a wiki, calendar, tasks, messenger, gallery, news, surveys, files and more from the built-in marketplace.

**Permissions.** Groups, roles and space-level permissions decide who can see, post and manage.

**Themes and branding.** Change logos, colors and themes to match your organization.

**Mobile.** HumHub works in mobile browsers and has an official app for iOS and Android.

---

## Deploy HumHub in Under 5 Minutes

1. Click **Deploy on Railway**. The admin password, database password and Mailpit password are generated for you.
2. Wait for the first boot, which runs every database migration and can take several minutes.
3. Open the HumHub domain and sign in as `admin` with the `HUMHUB_ADMIN_PASSWORD` value from the **Variables** tab.
4. Change the admin email from `admin@example.com` to your own address in your account settings.
5. Create your first space, then invite colleagues by email or add them under **Administration, Users**.

---

## Common Use Cases

- **Company intranet:** share news, policies and documents in one place staff actually visit.
- **Team collaboration:** give every team or project its own space with posts, files and tasks.
- **Associations and clubs:** run a members-only network with events and discussions.
- **Schools:** connect teachers, students and parents in private class spaces.
- **Customer or partner portals:** host a closed community for customers or resellers.
- **Remote teams:** replace scattered chat threads with searchable, organized updates.
- **Internal knowledge base:** keep how-tos in the wiki module next to the discussions.
- **Event planning:** coordinate events with the calendar module and RSVP.
- **Onboarding new hires:** give newcomers one place to find people, teams and documents.
- **Volunteer networks:** keep volunteers informed and organized across local groups.

---

## Configuration

| Variable | Required | Default | Description |
|---|---|---|---|
| `HUMHUB_ADMIN_USERNAME` | Optional | `admin` | First administrator's login, first boot only |
| `HUMHUB_ADMIN_PASSWORD` | 🔐 Auto-generated | `Hh-` plus a secret | First administrator's password |
| `HUMHUB_ADMIN_EMAIL` | Optional | `admin@example.com` | First administrator's email |
| `HUMHUB_SITE_NAME` | Optional | `HumHub` | Network name shown in the header and emails |
| `HUMHUB_ENABLE_REGISTRATION` | Optional | `false` | Opens anonymous sign-up on first boot |
| `HUMHUB_SMTP_HOST`, `HUMHUB_SMTP_PORT` | Auto-set | Mailpit, `1025` | SMTP server seeded on first boot |
| `HUMHUB_SYSTEM_EMAIL` | Optional | `noreply@` your domain | From address on system mail |
| `HUMHUB_PHP_MEMORY_LIMIT` | Optional | `512M` | PHP memory limit |
| `HUMHUB_DOCKER__NUMPROCS_WORKER` | Optional | `2` | Background queue workers |
| `MP_UI_AUTH` | 🔐 Auto-generated | `admin:` plus a secret | Login for the Mailpit inbox |

**Real email.** Mailpit catches every message, so invitations and notifications never reach real people until you change mail settings. In HumHub go to **Administration, Settings, Advanced, E-Mail**, enter your SMTP provider, and send a test. You can then delete the Mailpit service.

**Checking test mail.** Open the Mailpit domain and sign in with the user and password from `MP_UI_AUTH` to read what HumHub sent.

**Registration.** Sign-up is closed by default. Invite people from the admin panel, or turn on registration with approval under **Administration, Users, Settings**.

**Custom domain.** Add it in Railway and set `HUMHUB_BASE_URL` to the new address; it is applied on every boot.

**Modules.** Install modules from **Administration, Modules**. They are stored on the `/data` volume and survive redeploys.

**Sign-in options.** Add LDAP or Active Directory sign-in under **Administration, Users, Authentication**, so staff use their existing company accounts.

**Branding.** Upload a logo, set the site name with `HUMHUB_SITE_NAME`, and pick a theme or custom colors under **Administration, Appearance**.

**Performance.** Two queue workers send notifications and digests in the background. For larger networks, raise `HUMHUB_PHP_MEMORY_LIMIT` and the service's memory, and keep MySQL's buffer pool at least 1 GB.

**Backups.** Back up MySQL and the `/data` volume together; uploads and installed modules live on the volume.

---

## HumHub vs. Alternatives

| Feature | HumHub on Railway | Slack Pro | Microsoft Viva Engage | Discourse |
|---|---|---|---|---|
| Hosting | Self-hosted | Hosted SaaS | Hosted SaaS | Self-hosted or hosted |
| License | AGPL-3.0 | Proprietary | Proprietary | GPL-2.0 |
| Spaces and activity stream | ✅ | Channels | ✅ | Categories |
| Wiki, calendar and tasks | ✅ via modules | Via apps | Via Microsoft 365 | Via plugins |
| Per-user pricing | None | Yes | Microsoft 365 license | None self-hosted |
| Data on your server | ✅ | ❌ | ❌ | ✅ |
| Price | About $10–15/month total | $8.75/user/month | Microsoft 365 plans | Hosting cost |

Slack is the strongest real-time chat. Viva Engage suits companies already on Microsoft 365. Discourse is excellent for public forums. HumHub is built for private, intranet-style social networks.

---

## Dependencies for HumHub Hosting

- A Railway account.
- An SMTP provider for real invitations and notifications.

### Deployment Dependencies

- [HumHub on GitHub](https://github.com/humhub/humhub): source code and releases
- [HumHub documentation](https://docs.humhub.org/): admin and module guides
- [HumHub Docker image](https://hub.docker.com/r/humhub/humhub): image tags

### Implementation Details

The `stable` tag moves with HumHub's stable releases, so a redeploy can pick up a new minor version; back up MySQL first. The wrapper trusts Railway's proxy addresses so HumHub sees real client IPs and marks cookies secure, and it fixes MySQL 9 table collations that HumHub's checks would otherwise report.

---

## Frequently Asked Questions

**What is HumHub?**
An AGPL-3.0 open source social network and intranet with spaces, an activity stream and installable modules.

**How much does it cost to host HumHub?**
About $10–15/month on Railway for HumHub, MySQL and Mailpit, with no per-user fees.

**What is the admin login?**
Username `admin` with the `HUMHUB_ADMIN_PASSWORD` value from the Variables tab.

**Why don't invitation emails arrive?**
They go to the Mailpit test inbox. Set your SMTP provider in HumHub's email settings to deliver real mail.

**Can people sign up on their own?**
Not by default. Invite users or enable registration in the admin settings.

**Is there a mobile app?**
Yes. The official HumHub app for iOS and Android connects to your domain.

---

## Why Deploy and Host HumHub on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying HumHub on Railway, you get a private social intranet with spaces, posts and modules for your organization, without per-user subscription fees.


## Similar templates

- [Rocky Linux](https://railway.com/deploy/rocky-linux) — Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀
- [Foundry Virtual Tabletop](https://railway.com/deploy/X5tR6G) — Self-hosted virtual tabletop for role-playing games (license required)
- [Letta Code Remote](https://railway.com/deploy/letta-code-remote) — Run a Letta Code agent 24/7. No inbound ports, just deploy.

Open this page in a browser: https://railway.com/deploy/humhub-social-intranet
