Deploy HumHub: Self-Hosted Social Intranet & Enterprise Network
Run a private social network with spaces, posts and modules.
MySQL
Just deployed
/var/lib/mysql
mailpit
Just deployed
/data
humhub
Just deployed
/data
Deploy and Host HumHub on Railway
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
- Click Deploy on Railway. The admin password, database password and Mailpit password are generated for you.
- Wait for the first boot, which runs every database migration and can take several minutes.
- Open the HumHub domain and sign in as
adminwith theHUMHUB_ADMIN_PASSWORDvalue from the Variables tab. - Change the admin email from
admin@example.comto your own address in your account settings. - 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: source code and releases
- HumHub documentation: admin and module guides
- HumHub Docker image: 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.
Template Content
